GO-MVP Documentation

Complete documentation for the GO-MVP production-ready SaaS boilerplate

GO-MVP Documentation

GO-MVP is a production-ready SaaS boilerplate that gives you a complete backend and frontend — fully wired with authentication, payments, subscriptions, emails, and deployment. Clone it, configure your environment, and start building your product.

What You Get

Backend (Symfony + PHP)

  • User authentication — email/password registration, social login (Google, Apple via Firebase), JWT tokens with refresh rotation
  • Subscription payments — Stripe Checkout with recurring and one-time plans, webhook handling, feature gating
  • Admin panel — EasyAdmin backoffice for managing users and subscriptions
  • Transactional emails — Brevo for production, Mailpit for local development
  • Clean architecture — Hexagonal architecture with CQRS, domain events, and full test coverage

Frontend (Nuxt + Vue)

  • Landing page — Marketing page with hero, features, pricing, FAQ sections
  • Auth flows — Login, register, forgot/reset password, social login, email verification
  • Stripe checkout — Seamless payment flow with success/cancel pages
  • User dashboard — Profile management, subscription status, password changes
  • Dark theme — Polished dark UI with Tailwind CSS

DevOps & Deployment

  • Docker — Containerized development and production environments
  • CI/CD — GitHub Actions pipeline (test → build → deploy)
  • Dokploy — One-click deployment with automatic HTTPS

Tech Stack

LayerTechnology
BackendPHP 8.4, Symfony 7.4, FrankenPHP
FrontendNuxt 3, Vue 3, Tailwind CSS, TypeScript
DatabasePostgreSQL 16
CacheRedis 7
PaymentsStripe (recurring + one-time)
AuthJWT + refresh tokens, Firebase (social login)
EmailsBrevo (production), Mailpit (development)
AdminEasyAdmin
CI/CDGitHub Actions → GitHub Container Registry → Dokploy

How This Documentation Is Organized

  • Getting Started — Prerequisites and full-stack setup guide
  • Backend — Symfony backend architecture, features, API reference, and customization
  • Frontend — Nuxt frontend structure, components, composables, and features
  • Integration — How the backend and frontend work together
  • Deployment — Docker setup, production deployment, and launch checklist

Quick Start

  1. Clone both repositories (backend + frontend)
  2. Configure environment variables
  3. Start Docker containers
  4. Run database migrations and sync Stripe plans
  5. Open the frontend at http://localhost:3000

See the Full-Stack Setup Guide for step-by-step instructions.