AI SaaS Starter Kit - Next.js, Supabase, Stripe

AI SaaS Starter Kit is a complete, production-ready foundation for launching a subscription SaaS, now with a built-in AI agent. It ships with a working QR code generator as a demo tool, free and paid plans, Stripe billing, Google and email authentication, an admin dashboard, and a fully bilingual interface (English and Arabic with real RTL support).

NEW: AI agent

- A chat assistant that answers visitors from your own content: upload PDF, DOCX, TXT or MD files, paste text, or add Q&A pairs from the admin page. No code needed.

- It can also take action: show a logged-in user's plan and account status, and send a support message to your inbox after the user confirms.

- Add your own tools (orders, bookings, anything in your database) by creating one small file. A step-by-step guide and security rules are in the README.

- Works in English and Arabic, with daily limits to protect your API usage.

- Optional: it stays off until you add your own Gemini API key.

Try the live demo, upgrade with Stripe's test card 4242 4242 4242 4242, cancel, and delete the account to see the full customer lifecycle working.

What is included

- Google login and admin login, Free (5 uses per day) and Pro plans enforced on the server

- Stripe Checkout, customer portal and webhooks

- Admin dashboard with users, subscribers, usage and realtime contact messages

- Dark mode and a unified theme across public pages, admin and chat widget

- Pricing, privacy and terms pages, optional reCAPTCHA

Built with Next.js 16 (App Router), React, TypeScript, Tailwind CSS, Supabase (pgvector) and Stripe, plus the Gemini API for the AI features. Clean, typed, lint-free code that is easy to extend into your own product.

Detailed documentation and a changelog are included.

Features

- Next.js 16 App Router with TypeScript

- AI agent: answers from your own files, text and Q&A, shows the user's plan and sends support messages after confirmation (optional, uses your Gemini key)

- Add your own AI tools with one small file

- Admin knowledge page: upload PDF, DOCX, TXT, MD and manage the assistant

- QR code generator page (demo tool)

- Stripe subscriptions: checkout, webhooks, cancellation

- Pricing page with free and paid plans

- Supabase authentication: Google sign-in

- Separate admin login and protected admin dashboard (role-based)

- User settings page with account deletion (cancels the subscription)

- English and Arabic with full RTL layout (next-intl)

- Light and dark mode with a unified theme

- Contact, Privacy Policy and Terms pages included

- Server-side route protection

- Responsive design for mobile, tablet and desktop

- Ready to deploy on Vercel

Requirements

- Node.js 20.9 or later

- A Supabase project (free tier works)

- A Stripe account (test mode is enough to start)

- A Google Cloud OAuth client for Google sign-in

- A Vercel account (or any Node hosting)

- Optional, for the AI agent: a Gemini API key from Google AI Studio

Instructions

1. Unzip the package and run: npm install

2. Copy .env.example to .env.local and fill in your Supabase, Stripe and site URL values

3. Set up the Supabase tables as described in the README, and enable the Google provider in Supabase Authentication

4. Create a Stripe product and price, then add a webhook endpoint pointing to /api/stripe/webhook (use your real webhook path) and put its signing secret in your env file

5. Run: npm run dev

6. Deploy to Vercel, add the same environment variables, and set NEXT_PUBLIC_SITE_URL to your live URL

7. To make an admin, set role = 'admin' on the user's row in the profiles table

Full step-by-step details are in the included README.