β Prerequisites
- Node.js 18+ (Vite 5 requires Node 18 or newer)
- npm (or pnpm/yarn)
- Accounts/keys for: OpenRouter and/or Groq (for chat), Firebase (Auth + Realtime Database), optionally Gumroad (license verification)
π Quick Start
- Install dependencies
- Create
.envin the project root or Generate it via https://anyllm.xyz/env
- Start the dev server
π Provider Setup
OpenRouter (Chat API)
- Create an account and generate an API key.
- Set
VITE_OPENROUTER_API_KEYandVITE_OPENROUTER_API_URL.
Groq (Chat + Transcription)
- Create an account and generate an API key.
- Set
VITE_GROQ_API_KEY,VITE_GROQ_API_URL, andVITE_GROQ_TRANSCRIBE_URL.
Firebase (Auth + Realtime Database)
- Create a Firebase project.
- In Build β Authentication β Sign-in method, enable Google.
- In Build β Realtime Database, create a database (choose location, start rules as needed for your app). You can import
database.rules.jsonor configure rules in console. - Go to Project settings β Your apps (Web) and copy config values into the
VITE_FIREBASE_*variables.
Gumroad (License Verification, optional)
- Create a product and enable license keys.
- Find the product identifier (see Gumroad docs) and set
VITE_GUMROAD_PRODUCT_ID. - Set
VITE_UPGRADE_URLto your Gumroad checkout/overlay link if you use the in-app upgrade button.
βοΈ Configuration Reference
Central config lives insrc/config.ts (reads from import.meta.env).
- Branding & SEO:
VITE_SITE_NAME,VITE_SITE_URL,VITE_SITE_DESCRIPTION,VITE_SITE_KEYWORDS,VITE_OG_IMAGE_URL - External Links:
VITE_DOCS_URL,VITE_APP_URL,VITE_UPGRADE_URL,VITE_GITHUB_URL,VITE_TWITTER_URL,VITE_COMPANY_ABOUT_URL,VITE_CONTACT_EMAIL - Pricing / Gumroad:
VITE_PRICE_MONTHLY,VITE_GUMROAD_PRODUCT_ID - APIs:
VITE_OPENROUTER_API_URL,VITE_GROQ_API_URL,VITE_GROQ_TRANSCRIBE_URL,VITE_OPENROUTER_API_KEY,VITE_GROQ_API_KEY - Firebase:
VITE_FIREBASE_*
public/manifest.jsonβ PWA name/short_name/description/iconspublic/robots.txtandpublic/sitemap.xmlindex.htmlβ neutral meta; per-page SEO is set viasrc/components/SEO.tsx
π§° Development
- Dev server:
npm run dev - Lint:
npm run lint - Build:
npm run build(outputs todist/) - Preview:
npm run preview
βοΈ Deploy (Vercel)
- Add the repo on Vercel.
- Set all
VITE_*variables in Project β Settings β Environment Variables. - Build command:
vite build(default vianpm run build). - Output directory:
dist/. vercel.jsonin this repo routes SPA paths toindex.html.
π¨ Customize
- Replace logos in
src/assets/and PWA icons inpublic/icons/. - Update
public/manifest.jsonname/short_name. - Edit copy in
src/components/Hero.tsx,PricingSection.tsx, etc. - Adjust landing model sections in
src/data/models.ts.
π§― Troubleshooting
- Missing env screen: ensure all keys listed in the hint are present in
.env. - 401/403 from providers: verify the correct API key and endpoint URL; check billing.
- Firebase permission errors: review Realtime Database rules and authentication state.
- Google sign-in blocked: set your authorized domain in Firebase Auth settings.
π Security Notes
- Do not commit your real
.env. - Vite
VITE_*envs are exposed to the client. If you must protect provider keys, proxy requests through your own backend.
