# Ethiopian Calendar Website

> A comprehensive Next.js-based web application that provides Ethiopian calendar functionality, featuring date conversion, calendar views, and cultural information. The project uses modern web technologies including TypeScript, Tailwind CSS, and follows Next.js 13+ app directory structure. This application serves as a complete solution for Ethiopian calendar needs, from basic date conversion to cultural event tracking.

## Project Overview

The Ethiopian Calendar Website is designed to be the go-to resource for Ethiopian calendar information, providing:

- Accurate date conversion between Ethiopian and Gregorian calendars
- Real-time Ethiopian date and time display
- Comprehensive holiday and event tracking
- Cultural context for religious and national events
- Mobile-responsive design for all devices
- Multilingual support for broader accessibility

## Technical Stack

- **Framework**: Next.js 13+ with App Router
- **Language**: TypeScript for type safety
- **Styling**: Tailwind CSS for responsive design
- **State Management**: Jotai, React Context and Hooks
- **API**: Next.js API Routes
- **Testing**: Jest for unit testing
- **Deployment**: Vercel platform

## Core Features

### Date Conversion
- [Date Converter](app/date-converter): 
  - Convert dates between Ethiopian and Gregorian calendars
  - Support for date ranges

### Time and Date Display
- [Today's Date](app/todays-date): 
  - Current Ethiopian date display
  - Month and year information
  - Day of the week in Amharic
  - Date formatting options

- [Today's Date and Time](app/todays-date-and-time): 
  - Real-time Ethiopian time display
  - Time zone support
  - 12/24 hour format options
  - Time synchronization features

- [Ethiopian Today Local Time](app/ethiopian-today-local-time): 
  - Local time conversion to Ethiopian format

### Holiday Information
- [National Holidays](app/national-holiday): 
  - Complete list of Ethiopian national holidays

- [Christian Orthodox Holidays](app/christian-orthodox-holiday): 
  - Complete list of Christian Orthodox Holidays

- [Fasting Calendar](app/fasting): 
  - Fasting period schedules

## Documentation

### Project Structure
- [README.md](README.md): 
  - Project setup instructions

### Components
- [sharedComponents/](sharedComponents/): 
  - Reusable UI components

### Utilities
- [utils/](utils/): 
  - Date conversion functions
  - Time calculation utilities
  - Helper functions
  - Type definitions

### Types
- [types/](types/): 
  - TypeScript interfaces
  - Type definitions
  - Type utilities
  - Type guards

## Examples

### Main Features
- [Home Page](app/home): 
  - Feature showcase
  - Quick access to main functions
  - User guides
  - Latest updates

### Content
- [Blogs](app/blogs): 
  - Articles about Ethiopian calendar
  - Cultural information
  - Usage guides
  - News and updates

### Events
- [Habashe Events](app/habasheevents): 
  - Event calendar
  - Event details
  - Registration system
  - Event notifications

## Optional Features

### Information Pages
- [About](app/about): 
  - Project history
  - Team information
  - Mission statement
  - Contact details

### Support
- [Contact Us](app/contact-us): 
  - Contact email address
  - Feedback mechanism

- [Support](app/support): 
  - Support Ethiopian Calendar
  - Custom amounts to Support Ethiopian Calendar

### Additional Tools
- [QR Code](app/qrcode): 
  - QR code generation
  - Share functionality
  - Custom QR options

## Technical Configuration

### Styling
- [tailwind.config.ts](tailwind.config.ts): 
  - Theme configuration
  - Custom utilities
  - Plugin setup
  - Responsive design settings

## Development Guidelines

### Code Style
- Follow TypeScript best practices
- Use functional components
- Implement proper error handling
- Write comprehensive tests

### Performance
- Optimize images and assets
- Implement proper caching
- Use code splitting
- Monitor performance metrics

### Security
- Follow security best practices
- Regular security audits