Chameleon

Guide

Learn how to use and configure Chameleon AI SaaS features

User Guide

Welcome to the Chameleon User Guide. This section covers everything you need to know about using and configuring Chameleon.

What is Chameleon?

Chameleon is a powerful Next.js AI SaaS boilerplate that provides rich functionality and components to help you rapidly build modern web applications. Built with the latest technologies, Chameleon offers enterprise-grade features out of the box.

Key Features

  • 🚀 Fast Setup - Built on Next.js 15 with TypeScript
  • 🎨 Modern UI - Uses Tailwind CSS and Shadcn UI
  • 🌍 i18n Support - Built-in internationalization
  • 💳 Payment Integration - Stripe & Creem support
  • 🔐 Authentication - Google & GitHub OAuth
  • 🤖 AI Integration - Kling, Seedance, OpenAI, and more
  • 📊 Admin Dashboard - Complete user management and analytics
  • 📱 Responsive Design - Works perfectly on all devices

Prerequisites

Before you start, make sure you have:

System Requirements

  • Node.js 18+ - JavaScript runtime
  • pnpm (recommended) or npm - Package manager
  • Git - Version control

Recommended versions:

$ node -v
v22.2.0

$ pnpm -v
9.15.0

$ git --version
git version 2.39.3

Cloud Services (Optional)

Quick Start Guide

1. Installation

# Clone the repository
git clone https://github.com/chameleon-nexus/chameleon-saas.git
cd chameleon-saas

# Install dependencies
pnpm install

2. Environment Setup

Copy the example environment file:

cp .env.example .env.development

Configure essential variables:

# Database
DATABASE_URL="postgresql://user:password@host:5432/database"

# Authentication
NEXTAUTH_SECRET="your_secret"
NEXTAUTH_URL="http://localhost:3000"

# Admin emails
ADMIN_EMAILS="your-email@example.com"

# Payment (optional)
STRIPE_SECRET_KEY="sk_test_..."
STRIPE_PUBLISHABLE_KEY="pk_test_..."

# AI APIs (optional, can configure in admin)
OPENAI_API_KEY="sk-..."
KLING_ACCESS_KEY="..."

3. Database Setup

Run migrations to create tables:

pnpm db:push

4. Start Development Server

pnpm dev

Visit http://localhost:3000 to see your application.

Guide Sections

Configuration

Updates & Support

Learning Resources

Next Steps

Tutorials

Learn how to customize and extend Chameleon:

Feature Deep Dives

Explore Chameleon's powerful features:

Deployment

Deploy your application to production:

Getting Help

If you encounter any issues:

Happy building with Chameleon! 🚀