SONIQ — AI Song Creation Studio

Full-stack deployment: Vercel (serverless) + Supabase (auth + database).

Project Structure

soniq-vercel/
├── api/
│   ├── generate.js        ← Anthropic proxy with auth + usage metering
│   ├── auth.js            ← Signup / login / session endpoints  
│   └── songs.js           ← Cloud library CRUD
├── public/
│   └── index.html         ← Full SONIQ app
├── supabase-schema.sql    ← Run once in Supabase SQL editor
├── vercel.json
└── package.json

---

Deploy in 4 Steps (~20 minutes)

Step 1 — Supabase setup

1. Create free account at supabase.com
2. New Project → give it a name and password
3. SQL Editor → New Query → paste supabase-schema.sql → Run
4. Settings → API → copy these 3 values:
   • Project URL → SUPABASE_URL
   • anon public → SUPABASE_ANON_KEY
   • service_role → SUPABASE_SERVICE_ROLE_KEY (keep secret!)

Step 2 — Push to GitHub

git init
git add .
git commit -m "SONIQ v1.0"
git remote add origin https://github.com/YOU/soniq.git
git push -u origin main

Step 3 — Deploy to Vercel

1. vercel.com → Add New Project → import your repo
2. Framework: Other
3. Click Deploy (fails until env vars are set — that's OK)

Step 4 — Environment variables

Vercel → your project → Settings → Environment Variables — add all 5:

Variable	Where to find it
ANTHROPIC_API_KEY	console.anthropic.com → API Keys
SUPABASE_URL	Supabase → Settings → API → Project URL
SUPABASE_ANON_KEY	Supabase → Settings → API → anon public
SUPABASE_SERVICE_ROLE_KEY	Supabase → Settings → API → service_role
APP_URL	Your Vercel URL e.g. https://soniq.vercel.app

After saving → Deployments → latest → Redeploy. Done.

SONIQ_AI_PROVIDER is optional: auto (default) tries Anthropic first when ANTHROPIC_API_KEY is configured, then OpenRouter; anthropic or openrouter forces one provider without fallback. The API Key dialog accepts personal sk-ant-... and sk-or-... keys, and hosted generation forwards a saved key to its matching provider.

On the hosted app, choose Use Local Qwen 3.6 (Ollama) from AI Provider to run prompt-based writing on the computer running the browser. This uses the local Ollama model qwen3.6:latest; Ollama must be running on port 11434. Because browser security requires an explicit CORS allowlist, on Windows set the user environment variable below, then fully quit and restart Ollama:

[Environment]::SetEnvironmentVariable('OLLAMA_ORIGINS', 'https://www.mysoniq.com,https://mysoniq.com', 'User')
[Environment]::SetEnvironmentVariable('OLLAMA_FLASH_ATTENTION', '1', 'User')
[Environment]::SetEnvironmentVariable('OLLAMA_KV_CACHE_TYPE', 'q8_0', 'User')
[Environment]::SetEnvironmentVariable('OLLAMA_NUM_PARALLEL', '1', 'User')

Tested on an RTX 5080 (16 GB) with Ollama 0.40.4: flash attention plus a q8_0 cache runs Qwen 3.6 at about 65-80 tokens/s with no CUDA crash (older builds crashed with flash attention on; if that returns, fall back to 0 / f16). Also keep the Ollama app's context-length slider at 16k or lower — 128k reserves so much memory that models spill onto the CPU. These are Ollama-wide settings.

Backup mode: once a browser has activated Local Qwen, switching back to Use SONIQ Cloud keeps Local Qwen armed as a backup. If the cloud AI fails (not sign-in, plan limits or a cancel), main Generate and prompt-based writing retry on this computer's Ollama and show a toast. Browsers that never activated Local Qwen never contact localhost.

Local-mode prompts are sent from the browser directly to Ollama, not to SONIQ's AI provider API. Use AI Provider → Use SONIQ Cloud to switch back. This browser-local option applies to prompt-based generation; server-side account, publishing, and other API features continue to use their existing endpoints.

---

Local Development

npm install

Create .env.local (never commit):

ANTHROPIC_API_KEY=sk-ant-...
SUPABASE_URL=https://xxxx.supabase.co
SUPABASE_ANON_KEY=eyJ...
SUPABASE_SERVICE_ROLE_KEY=eyJ...
APP_URL=http://localhost:3000

npx vercel dev
# → open http://localhost:3000

---

Usage Limits

Plan	Songs/month	Library
Not signed in	3/hour	localStorage
Free (signed in)	5/month	Cloud sync
Pro ($9/mo)	Unlimited	Cloud sync

Manually upgrade a user in Supabase:

UPDATE user_profiles SET plan = 'pro' WHERE email = '[email protected]';

---

How the Security Works

Browser → POST /api/generate (Authorization: Bearer <jwt>)
        → Vercel Function verifies JWT with Supabase
        → Checks + increments usage counter
        → Calls Anthropic with your API key (server-side only)
        → Returns result

Your Anthropic API key never touches the browser. Ever.

---

Next: Add Stripe

1. Create products in Stripe: Pro $9/mo, Studio $19/mo
2. Add api/stripe-webhook.js — on checkout.session.completed, update user_profiles.plan = 'pro'
3. Add Upgrade button → Stripe Checkout link

Stripe quickstart: stripe.com/docs/billing/quickstart