MuseMVP

Cover Image

Welcome to the MuseMVP documentation. This is your starting point for learning about the starter kit, its core features, and how to use it for your application development.

What is MuseMVP?

The name MuseMVP comes from combining Muse (inspiration) and MVP (Minimum Viable Product). We hope this full-stack starter kit helps indie makers turn their inspiration into a launch-ready personal product MVP with less setup and more shipping.

MuseMVP is designed to help developers quickly build modern web products with common features like user authentication, billing, AI chat, and Content Management Systems (CMS). By maintaining platform independence in its architectural design, MuseMVP allows you to deploy the exact same codebase to different compute platforms without modifying any business logic, effectively eliminating vendor lock-in.

Core Principles

MuseMVP is built upon the following design principles:

AI Native - The project directory and code structure are intentionally optimized for LLMs. This helps AI coding assistants like Cursor or Copilot understand the application context faster and assist with business logic generation.
Deploy Anywhere - Maintaining architectural flexibility, the same codebase can be smoothly deployed to mainstream hosting environments out of the box.
Highly Customizable - While providing comprehensive feature modules, we insist on zero black-box encapsulation and a minimalist, modular configuration (such as Tailwind CSS v4 and shadcn/ui) to facilitate secondary development.

What Do You Get Right After Purchasing MuseMVP?

One purchase unlocks immediate access: source repository + full handbook + private community.

1) Get MuseMVP Source Code

Access the GitHub source repository and start cloning, customizing, and deploying immediately.

2) Access the Full MuseMVP Handbook

Visit /manual to unlock all handbook chapters and ongoing updates without premium content limits.

3) Exclusive License Key

Get your exclusive license key at /app/settings/license to unlock future AI automation services and MCP components.

4) Join the Private Community

Use the Discord invite to submit the email used to purchase MuseMVP, then join after approval. You can also stay active in GitHub Discussions.

With the source code, you can focus on business features instead of rebuilding infrastructure from scratch.
With full access to the MuseMVP Handbook, you follow a complete implementation path instead of piecing together fragmented information.
Submit your purchase email through Discord and join after approval, or discuss directly in GitHub Discussions.

Get your musemvp · GitHub invite and full access to the MuseMVP Handbook.

Submit your purchase email via the Discord invite, join the private community after approval, or discuss in GitHub Discussions.

Questions or Support

If you have any questions or need help, contact us via Contact or email support@musemvp.com.

One-line Summary

What you buy is runnable code + reusable methods + a collaborative community, so you can ship faster.

Features

Before diving into the technical details, here is an overview of the core modules MuseMVP provides out of the box:

Write Once, Deploy Anywhere

Our proudest feature: You can deploy the exact same codebase—with zero modifications—to Vercel, Cloudflare Workers edge nodes, and standard Docker environments, breaking free from platform lock-in.

Core Architecture

Full Stack Architecture

Built with Next.js 16 (React 19) and Hono. Frontend and backend coexist in the same repository.

Type-safe Data Layer

UI & Design System

Based on Tailwind CSS v4 and shadcn/ui (Radix Primitives), featuring built-in Framer Motion animations and dark mode setup.

Security & Forms

Integrated Zod data validation, React Hook Form handling, and Cloudflare Turnstile bot protection.

Authentication

Session Management

Deep integration with Better Auth, providing complete registration, login, logout, and session state handling.

Email & Password

Full email + password registration and login flow with input validation and password strength detection.

Email OTP Login

Supports passwordless login and registration via one-time email verification codes, improving signup conversion rates.

Social Login (OAuth)

Pre-configured one-click Google and GitHub OAuth authorization, ready to use out of the box.

Two-Factor Authentication (2FA)

Built-in TOTP-based two-factor authentication. Users can self-enable it in their settings to significantly boost account security.

Password Reset

Complete reset password flow with token validation and secure expiry handling.

Connected Social Accounts

Users can view and manage their linked third-party social accounts (e.g., Google, GitHub) from the settings page.

User Settings

Profile Management

Users can update their display name and upload or crop an avatar image, with changes taking effect immediately.

Email Change

Secure email address update flow requiring email verification confirmation before taking effect.

Password Settings

Supports changing passwords (for password accounts) and separately setting a password for social login accounts.

API Key Management

Users can create, view, test, and revoke API Keys from the settings panel, with configurable expiry dates and permission scopes.

Account Deletion

Users can self-delete their account from the settings page, with a confirmation dialog to prevent accidental deletion.

Payments & Billing

Billing Module

Muse Billing module to unify pricing strategies and invoice status synchronization within the app.

Payment Gateways

Out-of-the-box Stripe and Creem payment gateway webhooks and callback logic integration.

Billing Models

Flexible billing options, supporting both recurring subscriptions (monthly/yearly SaaS) and one-time lifetime deals (LTD).

Customer Portal

Integrated payment gateway customer portal allows users to manage billing, download receipts, and cancel subscriptions self-service.

Subscription Status Sync

Webhooks keep subscription states in real-time sync, ensuring user permissions always match their paid status.

Manual User Upgrade (Admin)

Admins can manually upgrade or change any user's subscription plan from the admin panel, no user action required.

AI Capabilities

Vercel AI SDK

Built heavily on the Vercel AI SDK for handling streaming text output and React component rendering from LLMs.

Ready-to-use Chat Interface

Provides a functional `aichat` UI that natively supports multi-turn context retention.

History Persistence

User AI chat histories are automatically synced to the database, ensuring session continuity upon page refreshes.

CMS, Docs & Internationalization

Content Management (CMS)

Combines Fumadocs and Content Collections to deliver a professional-grade documentation and blog system.

Premium Content Gate

Extended Markdown renderer supporting custom blocks to hide content behind a paywall overlay. Non-paying users see a blur overlay with upgrade prompts—ideal for knowledge product builders.

Blog System

Full-featured blog module with categories, tags, RSS feed support, and MDX content rendering.

Changelog

A product changelog page to record version history, build product transparency, and improve user retention.

Global i18n

Full-site internationalization via next-intl. Landing pages, dashboards, documentation, and blogs switch seamlessly between languages.

Landing Page & Marketing

Marketing Landing Page

A beautifully designed product landing page with hero section, feature highlights, pricing table, FAQ, and more—all built in.

Pricing Page

A billing-integrated pricing display module supporting multiple tiers, monthly/annual billing toggle, and discount labeling.

Contact Form

Cloudflare Turnstile-protected contact form with messages forwarded to your inbox via email.

Legal Pages

Pre-built Privacy Policy, Terms of Service, and Community Guidelines page templates—ready to customize and use immediately.

Newsletter Subscription

Built-in newsletter subscription endpoint to collect user emails and integrate with your email marketing service.

SEO Support

Automatic sitemap.xml generation and robots.txt configuration. All pages have built-in meta tags and Open Graph data for search engines and social sharing.

Theming

10+ Pre-built Themes

Over 10 carefully crafted theme presets including MuseMVP Default, T3 Chat, Twitter, Catppuccin, Mocha Mousse, Graphite, and Bubblegum with distinct color palettes.

Dark Mode

Every theme natively supports both light and dark modes, automatically following system preferences.

Complete Design System

CSS variable-driven design tokens let you override primary color, background, border radius, fonts, and all other style properties without touching any component code.

Admin Panel

User List Management

Admins can search, filter, and paginate through all registered users with real-time keyword search.

User Actions

Admins can perform the following actions on any user: resend verification email, assign/revoke admin role, delete account, manually upgrade subscription.

Analytics

Google Analytics

Built-in Google Analytics (GA4) integration ready to use out of the box, tracking page views, user behavior, and custom events.

Baidu Tongji

Simultaneous Baidu Tongji integration for products targeting the Chinese market, requiring zero additional engineering.

Custom Event Tracking

A unified `useAnalytics` hook lets you send tracking events to multiple analytics platforms simultaneously with a single line of code.

Backend Infrastructure

Object Storage

Universal S3 file upload interface encapsulation, seamlessly compatible with AWS, Cloudflare R2, or self-hosted MinIO.

Email Delivery

Resend API integration with React Email templates, covering login verification codes, password reset, welcome notifications, and more.

OpenAPI Docs

Backend API routes automatically generate OpenAPI documentation, facilitating frontend-backend collaboration and external API consumption.

Admin Dashboard

A built-in admin interface providing user data overview and permission management, with admin-only route protection.

Introduction