cms.fellies.org/README.md

CMS Monorepo (Bun + Biome + Next.js)

A baseline monorepo with:

• apps/web: public frontend app
• apps/admin: separated admin app
• packages/ui: shared UI primitives (shadcn-ready)
• packages/content: shared Zod schemas/types
• packages/db: Prisma + PostgreSQL data access
• packages/config: shared TypeScript config

Stack

• Bun workspaces
• Biome (lint + format)
• Next.js App Router + TypeScript + src/
• Tailwind CSS
• Prisma + PostgreSQL
• Zod
• Zustand
• TanStack (Query, Table, Form)

Quick start

1. Install dependencies:

bun install

2. Copy env and set your database URL:

cp .env.example .env

3. Generate Prisma client and run migrations:

bun run db:generate
bun run db:migrate
bun run db:seed

4. Run both apps:

bun run dev

• Web: http://localhost:3000
• Admin: http://localhost:3001

Useful scripts

• bun run dev
• bun run dev:web
• bun run dev:admin
• bun run lint
• bun run typecheck
• bun run check
• bun run format
• bun run db:generate
• bun run db:migrate
• bun run db:push
• bun run db:studio
• bun run db:seed

Recommended next packages

• Auth: better-auth or next-auth
• Uploads: uploadthing
• Rich text: @tiptap/react
• Caching/queue: bullmq, ioredis
• Email: resend
• i18n: next-intl
• Observability: @sentry/nextjs
• Testing: vitest, @testing-library/react, playwright

For TanStack specifically, this baseline already includes Query, Table, and Form. Add Virtual when you introduce very large lists:

• @tanstack/react-virtual