Skip to content

AI SaaS Starter Kit - Next.js, Convex, Trigger.dev, Better Auth, Polar.sh (Stripe)

Notifications You must be signed in to change notification settings

Dzivenu/AquaKit

Repository files navigation

AquaKit

🚧 WORK IN PROGRESS

This project is currently being built live on YouTube! Follow along and learn as I build this AI SaaS starter kit from scratch.

πŸ“Ί Subscribe to my YouTube channel to catch all the episodes

🎬 Watch the complete build series - Building AquaKit live!

Forks Stars Issues License

The complete AI SaaS starter kit with the ultimate developer stack - Next.js, TailwindCSS, Claude Code + Cursor, Better Auth, Convex, Trigger.dev, and Polar.sh. Ship your AI SaaS faster than ever.
View Demo Β· Report Bug Β· Request Feature

About This Project

AquaKit Screenshot

AquaKit is the ultimate AI SaaS starter kit designed to dramatically accelerate your development process. Built with today's most powerful developer tools - Next.js 15, TailwindCSS, Claude Code + Cursor, Better Auth, Convex, Trigger.dev, and Polar.sh - this starter kit eliminates months of setup and configuration, allowing you to focus on building your unique AI features and getting to market faster.

The entire stack is optimized for speed: From AI-powered development with Claude Code and Cursor, to real-time data with Convex, automated workflows with Trigger.dev, and seamless monetization with Polar.sh - every tool is chosen to maximize developer productivity and reduce time-to-market.

Key Features:

  • πŸš€ Speed-First Development: AI-powered coding with Claude Code + Cursor for 10x faster development
  • πŸ” Authentication Ready: Better Auth with Convex integration - secure user management out of the box
  • ⚑ Real-time Everything: Convex provides instant data synchronization and serverless functions
  • πŸ€– Background Jobs: Trigger.dev for reliable AI processing, webhooks, and scheduled tasks
  • πŸ’° Monetization Built-in: Polar.sh integration for subscriptions, payments, and customer management
  • 🎨 Beautiful UI: TailwindCSS v4 with modern, responsive components
  • πŸ“± Mobile-First: Responsive design that works perfectly on all devices
  • πŸ”§ Type-Safe: Full TypeScript support with strict type checking
  • ⚑ Lightning Fast: Turbopack for ultra-fast development and builds
  • 🧠 AI-Ready: Pre-configured patterns for integrating any AI model or API

Built With

🧠 AI Development Stack

Claude Code Cursor

πŸš€ Frontend Stack

Next.js React TypeScript Tailwind CSS

⚑ Backend & Infrastructure Stack

Convex Better Auth Trigger.dev

πŸ’° Monetization Stack

Polar.sh

Getting Started

To get a local copy up and running, follow these simple steps.

Prerequisites

  • Node.js (version 18 or higher)
  • npm or your preferred package manager

Environment Variables

To run this project, you will need to add the following environment variables to your .env.local file:

NEXT_PUBLIC_CONVEX_URL="your-convex-deployment-url"
CONVEX_SITE_URL="http://localhost:3000"

Installation

  1. Clone the repo
    git clone https://github.com/0xAquaWolf/AquaKit.git
  2. Install packages
    npm install
  3. Start the development server
    npm run dev

The application will be available at http://localhost:3000

(back to top)

Development

Available Scripts

  • npm run dev - Start development server with Turbopack
  • npm run debug - Start development server with Node.js debugger enabled
  • npm run build - Build for production with Turbopack
  • npm run start - Start production server
  • npm run lint - Run ESLint
  • npm run format - Format code with Prettier
  • npm run format:check - Check code formatting
  • npm run dev:backend - Start Convex development server
  • npm run dev:frontend - Start Next.js with HTTPS and Turbopack

Architecture Overview

This is a Next.js 15 application with App Router that integrates:

Authentication Stack:

  • Better Auth with Convex integration (@convex-dev/better-auth)
  • Auth client configured in src/lib/auth-client.ts
  • Authentication routes in src/app/api/auth/[...all]/route.ts
  • Convex auth configuration in convex/auth.config.ts

Convex Integration:

  • Convex backend with Better Auth plugin in convex/convex.config.ts
  • Client provider wraps the app in src/app/ConvexClientProvider.tsx
  • Schema definitions in convex/schema.ts
  • HTTP endpoints in convex/http.ts

Frontend Structure:

  • Next.js App Router with TypeScript
  • Tailwind CSS v4 for styling with custom configuration
  • UI components in src/components/ui/
  • Path aliases: @/* for src/* and @/convex/* for convex/*

Usage

AquaKit dramatically reduces development time by providing a complete, pre-integrated stack. Instead of spending weeks configuring tools and services, you can:

  • Ship in days, not months: Skip the tedious setup and focus on your unique AI features
  • Build with AI assistance: Claude Code + Cursor provide intelligent code completion and generation
  • Scale effortlessly: Real-time backend with Convex, background jobs with Trigger.dev
  • Monetize immediately: Built-in payment and subscription system with Polar.sh
  • Learn the modern stack: Perfect reference implementation of today's best developer tools

Perfect for:

  • AI startups wanting to move fast
  • Developers building AI-powered SaaS products
  • Teams looking to modernize their development stack
  • Anyone who wants to ship AI products faster

Roadmap

βœ… Core Stack (Completed)

  • Next.js 15 with App Router setup
  • Convex backend integration
  • Better Auth authentication system
  • TypeScript configuration
  • TailwindCSS v4 styling
  • Development tooling (ESLint, Prettier)
  • Claude Code integration guide
  • Cursor IDE configuration

🚧 AI & Automation Features (In Progress)

  • Trigger.dev background job examples
  • AI integration patterns and examples
  • Claude API integration templates
  • Automated workflow examples

πŸ’° Monetization Features (Planned)

  • Polar.sh subscription system integration
  • Payment processing setup
  • User dashboard and analytics
  • Usage tracking and billing

πŸ”§ Developer Experience (Planned)

  • Component library expansion
  • Testing suite implementation
  • CI/CD pipeline setup
  • API rate limiting and usage tracking
  • Performance optimization
  • Mobile responsiveness improvements
  • Docker setup for easy deployment

See the open issues for a full list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Twitter / X - @0xAquaWolf

Aquawolf Academy Discord

Acknowledgments

🧠 AI Development Tools

πŸš€ Core Stack Documentation

⚑ Backend & Infrastructure

πŸ’° Monetization & Business

πŸ”§ Additional Tools

(back to top)

Star History

Star History Chart

Farewell

Wholeness and balanced Vibrations πŸ™Œ

About

AI SaaS Starter Kit - Next.js, Convex, Trigger.dev, Better Auth, Polar.sh (Stripe)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published