# Big Countdown

> Create and share beautiful countdowns for any occasion. Free, instant, no account needed.

## About

Big Countdown (big-countdown.com) is a web application for creating shareable countdown timers. Each countdown displays the remaining days, hours, minutes, and seconds until a target date. Countdowns can be shared via a unique URL.

## Pages

- [Home](https://big-countdown.com/): Discover trending, ending-soon, and recently added countdowns. Browse by category.
- [Create](https://big-countdown.com/create): Create a new countdown with a title, target date/time, description, and visual style.
- [Browse](https://big-countdown.com/browse): Browse all public countdowns. Filter by category.
- [Browse by Category](https://big-countdown.com/browse/:category): Filter countdowns by category.
- [Search](https://big-countdown.com/search?q=term): Search across countdown titles and descriptions.
- [View Countdown](https://big-countdown.com/c/:slug): View a specific countdown with real-time ticking display.

## Features

- Create a countdown: Give it a title, set a target date and time, optionally add a description, choose a visual style, and set visibility (public or private).
- Share via URL: Every countdown gets a unique short URL like `/c/aB3xF2Qw` that can be shared anywhere.
- Real-time display: The countdown shows live days, hours, minutes, seconds until the target.
- Categories: Entertainment, Personal, Holidays, Sports, Gaming, Music, TV & Streaming, Movies, Science & Tech, Other.
- No account required: Public countdowns can be created and shared without registration.

## Data

Each countdown has:
- `title` (required): The countdown title, max 80 characters
- `description` (optional): Additional context, max 300 characters
- `target_at`: The target date and time (ISO 8601)
- `timezone`: The timezone for the event
- `category`: One of the predefined categories
- `is_public`: Whether the countdown is visible to everyone
- `slug`: A short unique identifier used in the URL

## Technical

- Framework: Angular 21 with Server-Side Rendering (SSR)
- Backend: Supabase (PostgreSQL)
- Countdowns are accessible at `/c/{slug}`
- OpenGraph meta tags are server-rendered for rich link previews

## Optional: Full documentation

See [/llms-full.txt](https://big-countdown.com/llms-full.txt) for complete documentation.