projectfinder

FlatFindr

FlatFindr is a production-ready MVP for an Airbnb-like property marketplace. Homeowners and agencies can list flats and houses, while visitors search, save favorites, and send inquiries.

Tech Stack

• Next.js 14 (App Router) + TypeScript
• Tailwind CSS
• Prisma + Postgres
• Auth.js (NextAuth) with email magic links + Google OAuth
• Cloudinary for image uploads

Features

• Listings CRUD with pricing, availability, amenities, and photos
• Search + filters, list/map toggle
• Inquiry threads with rate limiting
• Favorites with optimistic UI
• Agency profiles and listings
• Admin moderation dashboard
• SEO metadata, OpenGraph, sitemap, robots.txt
• Structured logging + error boundary + analytics hook

Getting Started

1. Install dependencies

   npm install
   

2. Start Postgres

   docker compose up -d
   

3. Configure environment

   cp .env.example .env.local
   

   Update values in .env.local.

4. Run database migrations + seed

   npm run db:push
   npm run db:seed
   

5. Start the app

   npm run dev
   

Scripts

• npm run dev - Start local dev server
• npm run build - Production build
• npm run lint - ESLint
• npm run test - Unit tests
• npm run db:push - Apply Prisma schema
• npm run db:seed - Seed sample data

Auth Providers

• Email magic link via SMTP settings in EMAIL_SERVER and EMAIL_FROM.
• Google OAuth using GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET.

Image Uploads

Uploads are signed server-side. Add Cloudinary credentials to .env.local.

Deployment (Vercel)

1. Create a new Vercel project pointing to this repo.
2. Set environment variables from .env.example in Vercel.
3. Add a managed Postgres instance or external Postgres URL.
4. Run prisma migrate deploy during the build step (Vercel build command).

Custom Domains

• Add flatfindr.com and www.flatfindr.com in the Vercel Domains settings.
• Configure DNS:
  • A record for flatfindr.com pointing to Vercel
  • CNAME for www to cname.vercel-dns.com

Seed Accounts

• admin@flatfindr.com (ADMIN)
• lister@flatfindr.com (LISTER)
• user@flatfindr.com (USER)

Notes

• Add a Mapbox token for the map view via NEXT_PUBLIC_MAPBOX_TOKEN.
• Inquiry creation is rate-limited to 5/hour per user.