Omidnw World - Anime Schedule

A modern anime schedule application built with React, TypeScript, and Vite. Stay up-to-date with your favorite anime shows, explore seasonal releases, and discover new series.

Omidnw World - Anime Schedule

A modern anime schedule application built with React, TypeScript, and Vite. Stay up-to-date with your favorite anime shows, explore seasonal releases, and discover new series.

Anime Schedule Screenshot

Features

Core Functionality

  • 📅 Weekly Schedule: View anime broadcasts organized by day of the week
  • 🗓️ Seasonal Anime: Browse anime by season and year
  • 🔍 Search Functionality: Find specific anime titles
  • 🌐 Translation Support: Translate anime descriptions to your preferred language
  • 🎨 Theme Customization: Choose from Dark, Light, Anime, and Retro themes
  • 📱 Responsive Design: Optimized for both desktop and mobile devices

Schedule Views

  • Card and table view options
  • Detailed anime information
  • Broadcast time in JST
  • Episode count and status

Theme System

  • Multiple theme options (Dark, Light, Anime, Retro)
  • Persistent theme selection
  • Smooth theme transitions

Translation Features

  • Support for multiple languages
  • RTL language support
  • Automatic language detection

Getting Started

Prerequisites

  • Node.js (v16 or newer)
  • npm or yarn package manager

Installation

  1. Clone the repository:

    git clone [repository-url]
    cd anime-schedule
    
  2. Install dependencies:

    npm install
    
  3. Start the development server:

    npm run dev
    
  4. Build for production:

    npm run build
    

Project Structure

src/
├── assets/      # Static assets (images, fonts)
├── components/  # Reusable React components
├── contexts/    # React context providers
├── hooks/       # Custom React hooks
├── pages/       # Page-level components
├── services/    # API services
├── styles/      # Global styles
├── types/       # TypeScript type definitions
└── utils/       # Utility functions

Technology Stack

Frontend

  • React 18: Modern React with hooks and functional components
  • TypeScript: Type-safe development
  • Vite: Fast build tool and development server
  • Tailwind CSS: Utility-first CSS framework
  • React Router DOM: Client-side routing

UI & Icons

  • Heroicons: Beautiful hand-crafted SVG icons

APIs & Services

  • Jikan API: Comprehensive anime data from MyAnimeList
  • LibreTranslate API: Free and open-source translation service

Architecture

  • Component-based UI architecture
  • Context API for state management
  • Custom hooks for business logic
  • Responsive design principles

Features in Detail

Weekly Schedule

The main feature displays anime broadcasts organized by days of the week, showing:

  • Anime title and synopsis
  • Broadcast time in JST
  • Episode information
  • Current airing status

Seasonal Browsing

Explore anime by different seasons and years:

  • Winter, Spring, Summer, Fall seasons
  • Year-based filtering
  • Popular and trending anime highlights

Search & Discovery

  • Real-time search functionality
  • Filter by genre, status, and type
  • Advanced search options

Customization

  • Themes: Multiple visual themes to match user preferences
  • Language: Multi-language support with translation
  • Layout: Flexible viewing options

API Integration

Jikan API

This application uses the Jikan API to fetch anime data:

  • Real-time anime information
  • Seasonal anime data
  • Search functionality
  • No API key required

LibreTranslate API

For translation features:

  • Multiple language support
  • Real-time translation
  • Fallback to original text if translation fails

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the project
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Development Notes

  • Created on: January 14, 2025
  • Status: Complete
  • Project Type: Web Application
  • Deployment: Ready for production

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments