Eclipse of the Final Realm

Production-ready Next.js 15 framework for an official science-fantasy novel universe website. The app intentionally ships with structure only: no fictional lore, characters, factions, cosmology, or story content is generated.

Stack

• Next.js 15 App Router, React 19, TypeScript
• Tailwind CSS dark cosmic UI
• PostgreSQL + Prisma ORM
• NextAuth v5 credentials authentication with role support
• Cloudinary media upload endpoint
• Scalable wiki, encyclopedia, chapter publishing, timeline, media, relationship, and search data model

Local setup

1. Install dependencies:

   npm install

2. Copy environment variables:

   cp .env.example .env

3. Start PostgreSQL and set DATABASE_URL in .env.

4. Generate the Prisma client and push the schema:

   npm run db:generate
   npm run db:push

5. Optional: seed an initial admin account:

   npm run seed

   Default credentials are admin@example.com / ChangeMe123!. Change them immediately.

6. Run the app:

   npm run dev

Production notes

• Use managed PostgreSQL with connection pooling.
• Configure AUTH_SECRET, AUTH_URL, and Cloudinary secrets in your host.
• Run prisma migrate deploy in CI/CD for production database changes.
• Place a CDN in front of static assets and Cloudinary transformations.
• Restrict admin registration in production by creating admins through the database or an invite flow.

Content policy

This repository provides only the framework and empty administrative workflows. All universe content must be authored manually through the admin dashboard.