Habit Pet

Bootstrap repo for the Calgary hackathon Habit Pet project.

Stack

Next.js
Supabase
Vercel
GitHub

Scope of this bootstrap

This repo currently stops at:

Next.js app scaffold
Supabase auth wiring from the starter
environment variable template
deployment-ready project structure

This repo does not yet include MVP feature pages, avatar logic, habits, streaks, or shop logic.

Local setup

Install dependencies:
```
npm install
```
Create local environment file:
```
cp .env.example .env.local
```

Add Supabase values to .env.local:

NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=

Start the app:
```
npm run dev
```
Create a production build when needed:
```
npm run build
```

Supabase

Create a Supabase project, then copy the project URL and anon key from Project Settings > API into .env.local and Vercel project environment variables.

The starter also supports Supabase's publishable key name, but this repo documents the anon key convention from the project plan.

Database workflow

Schema migrations live under supabase/migrations/.
Baseline catalog data lives in supabase/seed.sql and is safe to rerun during deploys because it uses idempotent upserts.
Local CLI config lives in supabase/config.toml for supabase start, supabase db reset, and related commands.
Production database sync runs from GitHub Actions on main using supabase db push --linked --include-seed before the app deploy relies on those changes.

Deploy

This repo includes .github/workflows/deploy.yml, which runs on pushes to main.

The workflow:

checks out the repo
runs npm ci, npm run lint, and npm run build
links the Supabase CLI to the production project
applies pending database migrations and reruns supabase/seed.sql via supabase db push --linked --include-seed
deploys the app to Vercel production only after the database sync succeeds

Required GitHub secrets

SUPABASE_ACCESS_TOKEN
SUPABASE_PROJECT_REF
SUPABASE_DB_PASSWORD
VERCEL_TOKEN
VERCEL_ORG_ID
VERCEL_PROJECT_ID

Required Vercel environment variables

NEXT_PUBLIC_SUPABASE_URL
NEXT_PUBLIC_SUPABASE_ANON_KEY

Frontend and backend are both served from this Next.js app. Supabase provides auth and database services.

2.4 KiB Raw Blame History