Lumina

Lumina is a quote-first journaling app. Users write entries, Lumina stores the raw words, and the mirror surfaces recurring verified quotes without diagnosing or interpreting the user.

Current Features

• Clerk authentication with custom sign-in, sign-up, SSO callback, and password reset pages
• Journal entries with optional mood and comma-separated feeling words
• Verified quote extraction for saved entries
• Structured mirror reports built from quotes, counts, and fixed reflection questions
• Dashboard activity stats for entries and verified quotes
• Raw data export with quote extractions
• Account settings, data deletion, and Stripe subscription management

Tech Stack

• Next.js 14 App Router
• React 18
• PostgreSQL with Prisma
• Clerk authentication
• OpenAI for quote extraction, with heuristic fallback when OPENAI_API_KEY is absent
• Stripe checkout and customer portal
• Tailwind CSS

Local Setup

npm install
cp .env.example .env.local

Fill in at least:

DATABASE_URL=postgresql://...
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
CLERK_SECRET_KEY=sk_test_...
NEXT_PUBLIC_APP_URL=http://localhost:5000

Then sync the database schema:

npm run db:push

Run the app:

npm run dev

The default local URL is:

http://localhost:5000

Active User Routes

• /
• /sign-in
• /sign-up
• /forgot-password
• /sso-callback
• /dashboard
• /journal
• /insights
• /reports
• /settings
• /checkout
• /checkout/return
• /checkout/success