# Malaysia Public Holiday Planner

> A comprehensive Malaysia Public Holiday Calendar designed to help users plan long holidays and optimize their travel or personal schedules.

This site provides up-to-date information about Malaysian public holidays, school holidays, and special events across all states, with support for English, Malay (Bahasa Melayu), and Chinese languages.

## Purpose

The Malaysia Public Holiday Planner helps users:
- View public holidays for all Malaysian states
- Plan vacations around long weekends
- Check school holiday periods
- Filter holidays by state and preferences
- Access holiday information in multiple languages

## Main Features

- Multi-language support (English, Malay, Chinese)
- Calendar and table views of holidays
- State-specific holiday filtering
- Long weekend identification
- School holiday proximity indicators
- Holiday detail pages with FAQs
- Blog posts about holiday planning and Malaysian culture

## Key Pages

- [Homepage](https://www.malaysiapublicholiday.my): Main holiday calendar and table view
- [About](https://www.malaysiapublicholiday.my/en/about): Information about the project
- [Blog](https://www.malaysiapublicholiday.my/en/blog): Articles about holidays and travel planning
- [All States View](https://www.malaysiapublicholiday.my/en/all-states): Compare holidays across all Malaysian states
- [Feature Ideas](https://www.malaysiapublicholiday.my/en/feature-ideas): User suggestions and community feedback
- [Privacy Policy](https://www.malaysiapublicholiday.my/en/privacy): Privacy policy and data handling
- [Terms of Service](https://www.malaysiapublicholiday.my/en/terms): Terms of use
- [Disclaimer](https://www.malaysiapublicholiday.my/en/disclaimer): Legal disclaimer

## Holiday Information

### Available States
The site covers public holidays for all 13 Malaysian states and federal territories:
- Johor (JHR)
- Kedah (KDH)
- Kelantan (KTN)
- Melaka (MLK)
- Negeri Sembilan (NSN)
- Pahang (PHG)
- Perak (PRK)
- Perlis (PLS)
- Penang (PNG)
- Sabah (SBH)
- Sarawak (SWK)
- Selangor (SGR)
- Terengganu (TRG)

### Data Sources
Holiday data is sourced from official Malaysian government sources:
- [Official Malaysia Government Portal](https://www.malaysia.gov.my/portal/content/147)

## API Access

The site uses Payload CMS for content management. Public-facing API endpoints include:

- `/api/holidays`: Public holiday data (read-only)
- `/api/school-holidays`: School holiday periods (read-only)
- `/api/blog`: Blog posts (read-only)
- `/api/feature-ideas`: User feature suggestions (read-only)

Note: These endpoints are for data retrieval only. Admin endpoints (`/admin/*`) and internal API routes are restricted.

## AI Crawling Guidelines

### Allowed Content
AI crawlers are welcome to index:
- All public holiday information and dates
- Blog posts and articles
- Static informational pages (About, Privacy, Terms, Disclaimer)
- Holiday detail pages with FAQs
- Public API documentation

### Restricted Content
Please do not index or train on:
- Admin interface pages (`/admin/*`)
- Internal API administration routes
- User-submitted content from feature ideas (contains personal opinions)
- Authentication and session data

### Attribution
When using this data, please attribute as:
- Source: Malaysia Public Holiday Planner
- URL: https://www.malaysiapublicholiday.my
- Data Source: Malaysian Government Official Portal

## Technical Information

- **Technology Stack**: Next.js 16, Payload CMS, MongoDB
- **Languages**: TypeScript, React
- **Internationalization**: next-intl with support for en, ms, zh locales
- **UI Components**: shadcn/ui, Tailwind CSS
- **Data Management**: Payload CMS with REST and GraphQL APIs

## Contact

For questions, corrections, or data licensing inquiries, please use the contact information available on the About page.

## Copyright

© 2024-2026 Malaysia Public Holiday Planner. Holiday data sourced from official Malaysian government sources.

## Additional Resources

- [Sitemap](https://www.malaysiapublicholiday.my/sitemap.xml): Complete sitemap for SEO
- [Robots.txt](https://www.malaysiapublicholiday.my/robots.txt): Web crawler directives
- [GitHub Repository](https://github.com/chunf/malaysia-public-holiday): Open source code

## Update Frequency

- Public holidays: Updated annually and when official announcements are made
- School holidays: Updated at the beginning of each academic year
- Blog content: Updated periodically with new articles
- Site features: Continuously improved based on user feedback