💸 Planifik - Personal Finance App

A small collaborative personal finance tracker built with Next.js 14, TypeScript, Tailwind CSS, and PostgreSQL (via Prisma). Made for my own use.

---

Features

• Google SSO sign-in via NextAuth.js
• Groups - share finances with family or roommates
• Folders - single-level grouping of items with custom icons & colors
• Items - Bills, Incomes, Credit Cards, Checking Accounts
• Recurrence - one-time, N months, or forever
• Pay / Receive - mark items as paid, optionally updating account balances
• Due date tracking - "Due today", "Due tomorrow", "Expired 2 days ago"
• Monthly navigation - clean month selector

---

Stack

Layer	Tech
Framework	Next.js 14 (App Router)
Language	TypeScript
Styling	Tailwind CSS + Outfit font
Database	PostgreSQL via Prisma ORM
Auth	NextAuth.js (Google OAuth)

---

Getting Started

1. Clone & install

git clone <this-repo>
cd planifik
npm install

2. Configure environment variables

cp .env.example .env

Fill in:

• DATABASE_URL - your PostgreSQL connection string
• NEXTAUTH_SECRET - generate with openssl rand -base64 32
• NEXTAUTH_URL - http://localhost:3000 for local dev
• GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET - from Google Cloud Console

3. Set up the database

# Run migrations
npx prisma migrate deploy

# Or for dev (creates migration if schema changed)
npx prisma db push

# Generate Prisma client
npx prisma generate

4. Run the dev server

npm run dev

Open http://localhost:3000.

---

Google OAuth Setup

1. Go to Google Cloud Console
2. Create a project -> APIs & Services -> Credentials
3. Create OAuth 2.0 Client ID (Web application)
4. Add Authorized redirect URIs:
   • http://localhost:3000/api/auth/callback/google (dev)
   • https://yourdomain.com/api/auth/callback/google (prod)
5. Copy Client ID and Secret to .env

Available Scripts

npm run dev         # Start development server
npm run build       # Production build
npm run start       # Start production server
npm run db:migrate  # Apply pending migrations
npm run db:generate # Regenerate Prisma client
npm run db:studio   # Open Prisma Studio (DB GUI)
npm run db:push     # Push schema changes (dev only)

---

Deployment

Environment variables for production

Make sure to set:

• DATABASE_URL pointing to your production Postgres instance
• NEXTAUTH_URL pointing to your production domain
• NEXTAUTH_SECRET (a strong random secret)
• Google OAuth credentials with the production redirect URI