Complete documentation for the ShipSafe SaaS boilerplate - a security-first Next.js boilerplate with Firebase, Stripe, and comprehensive security features.
🚀 Quick Start
New to ShipSafe? Start here:
- Installation & Setup - Get up and running in minutes
- First Steps - Learn the basics and run your first app
- Ship in 5 Minutes - Build a complete landing page quickly
- Configuration - Customize your app settings
📚 Documentation Sections
🎯 Get Started
Essential guides to get you up and running:
- Installation - Complete setup guide
- First Steps - Your first app walkthrough
- Project Structure - Understand the codebase organization
- Configuration - Customize
config.tsand app settings
Perfect for: First-time users, quick setup, understanding the architecture
🎓 Tutorials
Step-by-step guides to build features:
- Ship in 5 Minutes - Quick landing page tutorial
- Static Page - Create SEO-optimized pages
- Authentication - Implement login and signup
- API Routes - Create secure API endpoints
- Protected Pages - Add authentication guards
- Stripe Subscriptions - Set up recurring payments
- Custom Components - Build reusable components
- Database Queries - Query Firestore effectively
- Real-time Listeners - Set up real-time data sync
Perfect for: Learning by doing, building features, understanding patterns
⚙️ Features
Comprehensive feature documentation:
Core Features:
- Authentication - User authentication and sessions
- Billing & Payments - Stripe integration and subscriptions
- Database - Firestore integration and queries
- Security Features - 7-layer security architecture
Setup Guides:
- Firebase Setup - Configure Firebase
- Stripe Setup - Configure Stripe
- Environment Variables - Environment configuration
Advanced Features:
- SEO - SEO optimization and metadata
- Real-time Sync - Real-time data synchronization
- Error Handling - Error handling patterns
- Validation - Input validation with Zod
Integration Features:
- API Routes - Creating secure API endpoints
- Webhooks - Handling webhook events
- Email - Email functionality
Perfect for: Understanding features, setup instructions, integration guides
🧩 Components
Complete component reference:
UI Components:
- Button - Primary button component with variants
- ButtonCheckout - Stripe checkout button
- ButtonSignin - Authentication button
- ButtonGradient - Gradient button variant
- Card - Container component for content
- Input - Form input component with validation states
- Badge - Label/tag component
- Modal - Dialog component
- Loader - Loading spinner
- Logo - Logo component with light/dark variants
- BuiltWithShipSafe - Attribution badge (add your affiliate link!)
- TestimonialsAvatars - Social proof component
Template Components:
- Header - Navigation header
- Hero - Hero section with CTA
- Problem - Problem showcase section
- FeaturesGrid - Features grid layout
- FeaturesListicle - Interactive features list
- Testimonial - Testimonials carousel
- Pricing - Pricing table with plans
- FAQ - FAQ accordion
- CTA - Call-to-action section
- Footer - Site footer with links
Form Components:
- LoginForm - Email/password login
- SignupForm - User registration
Perfect for: Component usage, customization, building pages
🔒 Security
Security architecture and best practices:
- Overview - Complete 7-layer security architecture
- Middleware - Complete middleware security architecture
- API Security - API endpoint security
- Rate Limiting - Rate limiting configuration
- CSRF Protection - CSRF prevention
- Security Headers - HTTP security headers
- Authentication Security - Auth security patterns
- Tech Stack - Security-focused tech stack reasoning
Perfect for: Understanding security, implementing best practices, production hardening
🚀 Deployment
Deploy to production:
- Getting Started - Initial deployment steps
- Vercel Deployment - Deploy to Vercel
- Environment Setup - Configure production environment
- Security Checklist - Security configuration
- Monitoring - Monitor your deployment
Perfect for: Going live, production setup, monitoring
🎨 Extras
Additional guides and resources:
- Branding Setup - Logo, favicon, and branding
- Custom Themes - DaisyUI theme customization
- Email Templates - Customize email templates
- Cursor AI Workflow - AI-assisted development with Cursor and ChatGPT
- Useful Resources - Helpful tools and resources
- Troubleshooting - Common issues and solutions
Perfect for: Customization, AI-assisted development, troubleshooting, finding resources
🔗 Quick Links
Essential Setup
- Firebase Setup - Configure Firebase
- Stripe Setup - Configure Stripe
- Environment Variables - Environment setup
Popular Tutorials
- Ship in 5 Minutes - Quick start tutorial
- Authentication - Auth implementation
- Stripe Subscriptions - Payment setup
Security & Deployment
- Security Overview - Security architecture
- Vercel Deployment - Deploy to production
- Troubleshooting - Common issues
📖 Documentation Structure
The documentation is organized into clear, logical sections for easy navigation:
🚀 Get Started
Path: docs/get-started/
Essential guides for setup, installation, and first steps. Perfect for new users.
Includes:
- Installation guide
- First steps walkthrough
- Project structure overview
- Configuration guide
🎓 Tutorials
Path: docs/tutorials/
Step-by-step guides to build features and learn by doing.
Includes:
- Ship in 5 minutes
- Static pages
- Authentication
- API routes
- Protected pages
- Stripe subscriptions
- Custom components
- Database queries
- Real-time listeners
⚙️ Features
Path: docs/features/
Comprehensive documentation for all ShipSafe features and integrations.
Includes:
- Authentication
- Billing & payments
- Database
- Security features
- Firebase setup
- Stripe setup
- Environment variables
- API routes
- Webhooks
- SEO
- Real-time sync
- Error handling
- Validation
🧩 Components
Path: docs/components/
Complete reference for all UI components, templates, and forms.
Structure:
- ui/ - Reusable UI components (Button, Input, Card, Badge, Modal, etc.)
- templates/ - Page-level components (Header, Hero, Pricing, Footer, etc.)
- forms/ - Form components with validation
🔒 Security
Path: docs/security/
Security architecture, best practices, and implementation guides.
Includes:
- Security overview
- Middleware security architecture
- Authentication security
- API security
- Rate limiting
- CSRF protection
- Security headers
- Tech stack reasoning
🚢 Deployment
Path: docs/deployment/
Deployment guides, checklists, and production setup instructions.
Includes:
- Getting started
- Vercel deployment
- Environment setup
- Security checklist
- Monitoring
🎨 Extras
Path: docs/extras/
Additional resources, customization guides, and troubleshooting.
Includes:
- Branding
- Custom themes
- Email templates
- Cursor AI workflow
- Resources
- Troubleshooting
🎯 Documentation Philosophy
ShipSafe documentation follows these principles:
- Comprehensive - Complete guides with examples
- Practical - Real code from ShipSafe implementation
- Security-First - Security best practices throughout
- Boilerplate-Friendly - Easy to customize and extend
- Concept + Code - Explains why and shows how
💡 Tips for Using This Documentation
- Start with Get Started - If you're new, begin with installation and first steps
- Follow Tutorials - Learn by building features step-by-step
- Reference Components - Use component docs when building pages
- Check Features - Understand how features work before customizing
- Review Security - Always review security docs before production
🤝 Contributing
Found an error or have a suggestion?
- Open an issue on GitHub
- Submit a pull request
- Share feedback with the community
Built with ShipSafe - A security-first SaaS boilerplate ⚡