Reading the repo
Opening the box…
Reading the repo
Opening the box…
Assembly instructions
Saved setup from 10 h ago
Will it work on macOS?
Heads-upIt also needs 15 settings in .env (6 secret).
node --test)The schema is a set of SQL migrations in supabase/migrations/. Apply every file in name order in the Supabase SQL
Editor, or with psql:
for f in supabase/migrations/*.sql; do psql "$DATABASE_URL" -f "$f"; done
The migrations create the tables with RLS enabled, a trigger that seeds 11 default categories for each new user, the
audit log triggers, and the private receipts Storage bucket (1 MB limit; WebP, JPEG and PNG only).
Copy the example files and fill them in:
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env.local
Backend (backend/.env)
| Variable | Required | Description |
|---|---|---|
| SUPABASE_URL | Yes | Project URL, https://<project-ref>.supabase.co |
| SUPABASE_ANON_KEY | Yes | Anon or publishable key |
| DATABASE_URL | Yes | Transaction pooler connection string (port 6543) |
| SUPABASE_JWT_SECRET | No | Legacy HS256 secret; not needed with asymmetric signing keys |
| OPENROUTER_API_KEY / GEMINI_API_KEY | One of them | Vision model keys for receipt scanning |
| SMTP_USER / SMTP_APP_PASSWORD | No | Gmail address and app password for email; without them the bell still works |
| APP_URL | For email | Frontend address, used in email links and as the allowed CORS origin |
| CRON_SECRET | On Vercel | Any long random string; Vercel sends it with cron requests |
| APP_TIMEZONE | No | Defaults to Asia/Manila |
Frontend (frontend/.env.local)
| Variable | Required | Description |
|---|---|---|
| VITE_SUPABASE_URL | Yes | Project URL |
| VITE_SUPABASE_ANON_KEY | Yes | Anon or publishable key |
| VITE_TURNSTILE_SITE_KEY | No | Cloudflare Turnstile site key; leave empty while CAPTCHA is off |
| VITE_DEMO_EMAIL / VITE_DEMO_PASSWORD | No | Demo login shown on the sign-in page; it is public, so use a password that is used nowhere else |
| VITE_API_URL | No | Defaults to /api, which the Vite dev server proxies to http://localhost:8000 |
# Terminal 1: backend on http://localhost:8000
cd backend
python -m venv .venv
.venv/Scripts/python -m pip install -r requirements.txt # macOS/Linux: .venv/bin/python
.venv/Scripts/python -m uvicorn main:app --reload --port 8000
# Terminal 2: frontend on http://localhost:5173
cd frontend
npm install
npm run dev
https://<project-ref>.supabase.co/auth/v1/callback.http://localhost:5173/sign-in and
https://<your-domain>/sign-in.localhost and your deployed domain. Put its site key
in VITE_TURNSTILE_SITE_KEY, both locally and on Vercel.[!IMPORTANT] Turning CAPTCHA on in Supabase before the frontend deploy lands makes every email sign-in fail. CAPTCHA covers the whole Supabase project, so local email sign-in needs the real site key too; Cloudflare's test keys will not work.
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/WWH16/AntTipid-v2.git cd AntTipid-v2
Python 3, Node.js
brew install python brew install node
In the maintainers' order. Do the README instructions above first — they cover steps outside the terminal.
for f in supabase/migrations/*.sql; do psql "$DATABASE_URL" -f "$f"; done cp backend/.env.example backend/.env cp frontend/.env.example frontend/.env.local python -m venv .venv .venv/Scripts/python -m pip install -r requirements.txt # macOS/Linux: .venv/bin/python .venv/Scripts/python -m uvicorn main:app --reload --port 8000 npm install npm run dev
No reports for macOS yet.
GitManual AI Agent reads the 3 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.