Nitrate

Your films. Their films. Our films.

Nitrate is a social film diary and Movie Club app. Track films, keep reviews and lists, discover people with shared taste, and organize a group from movie ideas through picks, a wheel or vote, scheduling, and post-film discussion.

The local folder is still named LetterCube; the product, repository and hosting project are Nitrate. Product copy comes from src/lib/brand.ts.

Live app · GitHub

Current capabilities

• Accounts, onboarding, profiles, following, blocking, notifications and moderation.
• Film/person discovery with TMDB and a local catalogue fallback.
• Diary entries, rewatches, half-star ratings, reviews, watchlists and private notes.
• Collaborative lists, saved/pinned lists, physical/digital ownership and account export.
• Personal statistics and yearly recaps, club Yearbooks and revocable snapshot shares.
• Recommendations, Tonight, taste comparison, taste circles and followed filmmakers.
• Movie Clubs with optional themed rounds, sealed member picks, blind voting, random wheel selection, explicit manager overrides, screening polls, RSVP, calendars, diary logging, ratings, discussion, reactions and optional Tenor GIFs.
• Network discovery with evidence thresholds and administrative feature controls.
• Light/dark themes, responsive navigation, reduced motion and a PWA offline fallback.

This is a source-backed inventory, reviewed 27 October 2026. Unit/build checks and public HTTP checks have different coverage from signed-in, database, email and physical-device testing. See verification and known gaps, including the unresolved club aggregate blind-rating gap.

Documentation

Document	Purpose
Features	Implemented workflows and conditional capabilities
Status	Current verification evidence and limits
Handoff	Setup, environment, migrations, deployment and operations
Storage	Safe disk cleanup, recovery and worktree policy
Roadmap	Remaining gaps and priorities
Design & product	Product principles, surfaces, design and accessibility
Product brief	Audience and concise product direction
Decisions	Architecture, constraints and historical decisions
Club terminology	Member-facing vocabulary
Renaming	Brand configuration and infrastructure identifiers
Historical releases

Stack and architecture

Next.js 15.5.x (App Router), React 19, strict TypeScript, Tailwind CSS 4, PostgreSQL, Drizzle, custom sessions, TMDB, Resend and optional Tenor. Use Node 20 or newer; the lockfile is authoritative for dependency versions.

src/app/          Pages, API routes, server rendering and gated dev fixtures
src/components/   Shared UI and interactive workflows
src/server/       Services, actions, auth, privacy, providers, email and import
src/server/db/    63 tables in the dedicated nitrate schema
src/lib/          Shared helpers, pure domain logic and brand configuration
drizzle/          Ordered SQL migrations and metadata, 0000 through 0017
scripts/          Deliberate migration and local storage commands
test/             Test guards and storage safety tests

Authorization belongs on the server. Film state changes share one service; rewatches retain independent history. Ratings use integers 1–10 for half stars. The wheel animates a server-committed result; replay does not draw again. Managers can explicitly edit the pool or choose/correct a result before the night is completed, with permission checks and attribution.

Local setup

npm ci
cp .env.example .env.local
# Set DATABASE_URL and SESSION_SECRET; configure optional providers as needed.
npm run db:migrate   # confirm this is the intended development database first
npm run dev

Database migrations are deliberate, never an app startup side effect. Application and migration credentials can target a live shared database: read Handoff before running them.

npm run verify       # TypeScript, lint, unit tests, production build
npm run test:storage # Temporary-repository cleanup safety checks

Database integration is separate and opt-in:

# Point TEST_DATABASE_URL at a distinct disposable database first.
npm run db:migrate:test
npm run test:integration

Free up local disk space

npm run storage:report -- --worktree-dependencies
npm run storage:clean -- --worktree-dependencies

These commands inspect the main checkout and registered worktrees inside .claude/worktrees/. Cleanup removes generated build/test files and, with the flag above, duplicate worktree dependencies. It preserves source, dirty work, Git history, environment files, images and worktree checkouts. To also remove the main dependency install, add --dependencies, then restore it with npm ci. See Storage for safeguards and recovery.

Attribution and licence

Film metadata and artwork are provided by TMDB. This product uses the TMDB API but is not endorsed or certified by TMDB. Released under the MIT License.