BandPal is a social network for musicians and people looking to join or build a band. It also includes tools for band administration and commerce.

• Next.js 15 (App Router)
• Bun (Package manager & runtime)
• Supabase (Auth, Database, Edge Functions, Realtime)
• Prisma (ORM)
• Infisical (Secrets manager for environment variables)
• Tailwind CSS
• Playwright (E2E testing)
• Algolia (Search/autocomplete)
• Vercel (Hosting & CI/CD)
• Husky (Git hooks)

• Bun
• Docker Desktop
• Infisical CLI
  (Install with bun add -g @infisical/cli if not already installed)

1. Clone the repo

2. Install dependencies:

   bun install

3. Start Supabase (runs with Docker):

   bun supabase:start

4. Reset & seed local DB:

   bun db:reset:dev

5. Run the dev server:

   bun dev

6. (One-time) Enable realtime for chat messages:

   i. Visit Supabase Studio

   ii. Navigate to public.Message table

   iii. Enable "Realtime" in the top-right

We use Infisical to manage secrets for both development and production.

Use infisical run --env=dev -- <command> to inject variables locally. This is handled automatically in all bun scripts.

• App Router (Next.js 15) using the app/ directory

• Database managed with Prisma and Supabase

• Search powered by Algolia

• State management handled inline via server actions and local state

• Realtime chat via Supabase Channels

• Auth via Supabase (email/password & social)

• Use feature branches

• PRs are automatically deployed via Vercel Preview Deployments

• Husky runs pre-commit checks (formatting, linting)