Purranormal Activity

Track magical mishaps and spooky shenanigans of an enchanted kitten. This project is now powered by TanStack Start and deployed on Cloudflare Workers.

Live

• Production: https://purranormal-activity.workers.dev

Stack

• Framework: TanStack Start + TanStack Router
• Runtime/Deploy: Cloudflare Workers
• Build tool: Vite
• Language: TypeScript
• DB: Turso + Drizzle ORM
• Styling: Tailwind CSS
• Lint/format: Biome

Requirements

• Node.js 22.x
• pnpm

Setup

1. Install dependencies:

pnpm install

2. Create local env file:

cp .env.example .env

3. Fill .env with required values.

Development

Run dev server (keeps current project behavior with patch version bump):

pnpm dev

If you need to skip the automatic version bump, run Vite directly:

vite dev

Default local URL is shown in terminal (typically http://localhost:3000).

Scripts

• pnpm lint - run Biome checks
• pnpm format - format code
• pnpm lint:fix - apply Biome fixes
• pnpm build - production build (TanStack Start / Vite)
• pnpm preview - preview built app locally
• pnpm cf-typegen - generate Worker env types from Wrangler config
• pnpm deploy - build and deploy to Cloudflare Workers (no manual pre-build required)

Cloudflare Workers

• Project config: wrangler.jsonc
• Deploy script uses generated build config: dist/server/wrangler.json
• Worker name: purranormal-activity

Manual deploy alternative:

pnpm run build:start
wrangler deploy --config dist/server/wrangler.json

Dry-run deploy:

wrangler deploy --dry-run --config dist/server/wrangler.json

Core Routes

• /
• /explore
• /new
• /:id
• /:id/edit
• /api/* internal routes

Manual QA

See: wiki/manual-test.md

License

MIT. See LICENSE.