Berea Bazaar

Berea Bazaar is a campus-focused marketplace and community platform built with Next.js and Supabase.

Core capabilities include:

• Marketplace listings (free, sell, lend, rent)
• Private wishlists with potential-match notifications
• In-app messaging and reviews
• Free Food event posting and browsing
• Building-aware location metadata with map browsing

Documentation Hub

Full documentation lives in docs/README.md.

Direct links:

• Architecture
• Setup Guide
• Environment Variables
• Database Schema and Migrations
• HTTP API Reference
• Feature Documentation
• Security and Access Model
• Operations Runbook

Tech Stack

• Next.js App Router
• TypeScript + React
• Tailwind CSS + Radix UI
• Supabase (Auth, Postgres, RLS)
• Vercel Blob for private image storage
• Leaflet for listing map view

Quick Start

1. Install dependencies.

   npm install

2. Configure environment variables in .env.local.

3. Run SQL migrations in sequence (see docs/DATABASE.md).

4. Start the app.

   npm run dev

5. Open http://localhost:3000.

Scripts

• npm run dev
• npm run build
• npm run start
• npm run lint
• npm run backfill:buildings

Important Notes

• Keep secrets out of git.
• Use migration scripts for all schema changes.
• Keep docs updated in the same PR as behavior or schema changes.

Contribution Standard

When adding or changing features:

1. Update affected API docs in docs/API.md.
2. Update schema docs in docs/DATABASE.md if a migration is added.
3. Update feature docs in docs/FEATURES.md.
4. Add operational notes to docs/OPERATIONS.md when needed.