# Yozora (夜空)

> Fast seasonal anime broadcast schedule radar, 1080p creditless theme player, and synchronized personal watchlist platform.

## Overview
Yozora (https://yozora.moe) is a high-performance web platform built for anime viewers, researchers, and AI agents. It indexes seasonal television releases, delivers millisecond-accurate broadcast countdowns synced to Tokyo television networks (JST), streams 1080p creditless opening (OP) and ending (ED) themes via AnimeThemes.moe, and supports seamless AniList watchlist tracking.

## Core Pages & Features
- [Home](https://yozora.moe/): Seasonal spotlights, trending broadcasts, top-rated anime, and recent soundtrack releases.
- [Airing Radar](https://yozora.moe/airing): Live weekly broadcast schedule with real-time episode countdowns synced to Tokyo JST.
- [Seasonal Archive](https://yozora.moe/seasonal): Interactive seasonal cour browser (Winter, Spring, Summer, Fall) spanning 1970–present.
- [Catalog Search](https://yozora.moe/search): Instant full-text search with multi-parameter filtering (genres, formats, years, status).
- [About & Architecture](https://yozora.moe/about): Complete system architecture, dual-engine failover details, caching layers, and FAQs.
- [Privacy Policy](https://yozora.moe/privacy): Zero-telemetry privacy policy, local-first storage, and Clerk authentication security.

## Machine-Readable Specifications
- [Full LLM Context](https://yozora.moe/llms-full.txt): Comprehensive deep-context documentation and data schema for AI models.
- [Pricing & Open Access Specification](https://yozora.moe/pricing.md): FOSS license, feature tier breakdown, and comparison context for AI agents.
- [Google Open Knowledge Format Bundle](https://yozora.moe/okf/index.md): Agent-readable knowledge graph concepts (OKF v0.1).
- [Dynamic XML Sitemap](https://yozora.moe/sitemap.xml): Complete URL set with Google Image metadata for all catalog titles.
- [Crawler Directives](https://yozora.moe/robots.txt): Web crawler index permissions and AI agent guidance.
- [OpenSearch Specification](https://yozora.moe/opensearch.xml): Browser auto-discovery search provider definition.

## Technical Architecture & Key Facts
- **Platform Name**: Yozora (夜空 — Japanese for "Night Sky")
- **Official URL**: https://yozora.moe
- **Framework**: TanStack Start, React 19, Vite, Nitro SSR, Tailwind CSS v4, Base UI
- **Data Integrations**: AniList GraphQL API (primary), Jikan v4 REST API (failover), AnimeThemes.moe (themes)
- **Caching**: L1 in-memory single-flight Map + L2 Upstash Redis via REST (fail-open design)
- **Authentication**: Clerk with SSR middleware and neon PostgreSQL database
- **Telemetry**: Zero third-party tracker scripts. Complete user privacy.
- **Repository**: https://github.com/shiinasaku/yozora