🌸 AniDev

AniDev is a modern anime streaming and exploration platform rebuilt from scratch as AniDev-v2. It is not just an API — it's the product: a full anime-discovery experience (search, collections, watch progress, schedules, profiles, optimized streaming) served by a fast edge backend.

Astro 6 (SSR) · Drizzle ORM · Better Auth · Tailwind v4 · Zod 4 · Biome · Vitest

Intro: AniDev v2 re-does the original AniDev from zero on a new stack (Astro SSR + Postgres + Dragonfly + Rustrak). The feature set below is the target — v2 ships it incrementally through OpenSpec-driven changes. See Current Status for what exists today.

Product vision

• 🎨 Modern design — responsive, smooth astro:transitions.
• 🔍 Dynamic search — debounced queries, advanced filters (genre, studio, rating, year, season, status).
• 📺 Video playback — high-quality anime streaming.
• 📚 Collections & multiple lists — Collection, Completed, To-Watch, Watching.
• 🔄 Progress tracking — watch history + progress indicators.
• 📅 Schedule system — calendar view of upcoming releases.
• 👤 User profiles & preferences — avatar, accent color, parental control.
• 🖼️ Image optimization — resize / WebP · AVIF / quality via Sharp.
• ⚡ Redis caching — fast API responses with configurable TTL.
• 🛡️ Robust error handling — AppError, HTTP mapping, security headers.
• 🎯 Code quality — Biome + Prettier + Vitest (TDD).

Current status (v2, rebuilding from scratch)

Today v2 ships the backend foundation + API + minimal shell; product features arrive incrementally, each tracked as an OpenSpec change (openspec/changes/):

• ✅ API routes — auth, anime, music, user, search-history (Zod-validated, enveloped responses, response-schema validation in the wrapper)
• ✅ Auth (session middleware) — Better Auth email/password
• ✅ Cache layer (Dragonfly/Redis-compatible), image proxy (media domain)
• ✅ Advanced catalog search — season/score filters, whitelist sort, indexed free-text (pg_trgm), fail-closed parental floor, per-user search history
• ✅ Self-hosted infra — PostgreSQL, Dragonfly, Rustrak (docker compose local stack)
• ✅ Testing — Vitest unit + real-Postgres integration + Playwright E2E, CI gate, SemVer releases
• ✅ Pages: / (home), /anime/[id], /anime/[id]/[slug]
• 🚧 Streaming, homepage/hero + carousels, taxonomies, collections, progress, schedule, profile UI — to build (OpenSpec changes drive them)

Stack

• Runtime: Bun (primary), Node.js ≥ 22.12.0
• Framework: Astro 6 SSR with the @astrojs/vercel adapter (output: 'server')
• Database: PostgreSQL via Drizzle ORM (pg dialect)
• Cache: Dragonfly (Redis-compatible)
• Auth: Better Auth 1.5.5 (email/password, Drizzle Postgres adapter)
• Monitoring: Rustrak (self-hosted, Sentry-SDK compatible; no-ops when DSN unset)
• Styling: Tailwind CSS v4 (@tailwindcss/vite plugin)
• Validation / Logging: Zod 4, Pino (LOG_LEVEL)
• Quality: Biome format+lint, Prettier (*.astro), Vitest (@vitest/coverage-v8)

Quick start

git clone https://github.com/Sebas200702/anidev-v2.git
bun install
cp .env.example .env   # Windows: Copy-Item .env.example .env
bun run dev              # http://127.0.0.1:4321

Env vars are validated eagerly at import (src/config/env.ts); a missing/invalid required value fails fast.

Environment

Variable	Req	Notes
DATABASE_URL	yes	PostgreSQL connection URL (postgres:// / postgresql://)
REDIS_URL	yes	Dragonfly/Redis connection URL (redis:// / rediss://)
APP_BASE_URL	yes	Base URL (also Better Auth API_BASE)
BETTER_AUTH_SECRET	yes	≥ 32 chars
SENTRY_DSN	no	Monitoring no-ops when absent
PUBLIC_SENTRY_DSN	no	Client-exposed mirror of SENTRY_DSN for browser capture
LOG_LEVEL	no	trace|debug|info|warn|error|fatal
NODE_ENV	no	Defaults to development

There is no BETTER_AUTH_URL — the base URL is APP_BASE_URL.

For local development against the full self-hosted stack (PostgreSQL + Dragonfly + Rustrak) run docker compose up -d and copy .env.local.example → .env.local (local credentials, separate from production). Object storage (MinIO, for profile avatar/banner uploads) is optional and lives behind the storage profile: docker compose --profile storage up -d --build.

Commands

Script	Purpose
bun run dev	Astro dev server
bun run build	Production build (Vercel output)
bun run preview	Run the built output locally
bun run format	Biome format (excludes .astro)
bun run format:astro	Prettier on .astro
bun run check	Biome lint + format check
bun run check:write	Biome lint + safe fixes
bun run check:types	Astro/TS typecheck (astro check)
bun run astro sync	Regenerate .astro/types.d.ts
bun run test / test:watch / test:coverage	Vitest
bun run test:integration	Integration specs against a real Postgres (RUN_DB_TESTS=1; needs the docker stack + migrate + seed)
bun run test:e2e / test:e2e:ui / test:e2e:install	Playwright E2E (API + browser)
bun run db:seed:e2e	Seed the deterministic rows E2E asserts against
bun run auth:generate / auth:migrate	Better Auth schema/migrations
bun run db:generate / db:migrate	Drizzle migrations (PostgreSQL)
bun run release:*	standard-version release — see Versioning

Development methodology — OpenSpec (SDD)

Spec-Driven Development. Every feature passes SPECIFY → PLAN → TASKS → IMPLEMENT, managed via OpenSpec (openspec/); the source of truth is openspec/specs/ and active work lives in openspec/changes/<change>/ (proposal.md, design.md, specs/delta, tasks.md). Completed changes are archived to openspec/changes/archive/ with their deltas synced into openspec/specs/.

This is the beginning of the README. Read the rest at the original. Read the full README ↗