Why FSS?
FSS (Full Stack Starter) is a modern, production-ready platform built for speed, scalability, and developer experience.
🚀 Key Benefits
| Feature | Benefit |
|---|---|
| Full-Stack Architecture | Backend, frontend, and mobile in one cohesive codebase |
| Production Ready | Built with battle-tested technologies: NestJS, Next.js, Prisma, Redis |
| Type-Safe | End-to-end TypeScript for fewer bugs and better IDE support |
| Scalable | Horizontal scaling with Redis caching and PostgreSQL |
| Secure | Built-in auth, MFA, rate limiting, and security best practices |
| Developer Experience | Hot reload, Docker support, and automated setup scripts |
🎯 Perfect For
- SaaS Startups - Launch faster with pre-built authentication, payments, and admin panels
- Enterprise Apps - Scalable architecture with enterprise-grade security
- Multi-Platform - Web + Mobile (iOS/Android) from a single codebase
- API-First | RESTful API with Swagger documentation ready to consume
🛠️ Tech Stack
- Backend: NestJS + PostgreSQL + Redis
- Frontend: Next.js + React
- Mobile: React Native (Expo)
- Database: Prisma ORM
info
Ready to build something amazing? Let's get started in under 5 minutes!
Quick Start Guide
Welcome to FSS! This guide will help you get up and running in just a few minutes.
Prerequisites
Before you begin, ensure you have the following installed:
| Requirement | Version | Notes |
|---|---|---|
| Node.js | 20.x or higher | LTS version recommended |
| npm | 10.x or higher | Comes with Node.js |
| PostgreSQL | 14+ | Database (standalone or Docker) |
| Redis | 7+ | Cache (standalone or Docker) |
| Docker | 24.x or higher | Optional, for containerized deployment |
| Docker Compose | 2.x or higher | Optional, for multi-container setup |
info
For mobile development, you'll also need:
- Expo CLI:
npm install -g @expo/cli - Xcode (macOS) for iOS development
- Android Studio for Android development
Installation
Option 1: Automated Setup (Recommended)
The fastest way to get started is using the automated setup script:
# Clone the repository
Download the FSS package from the FSS dashboard.
cd fss
# Backend setup (from projects/fss/backend)
cd projects/fss/backend
# Install dependencies
npm install
# Copy environment file
cp .env.example .env
# Configure your .env file with database and Redis URLs
# Start with automated script
./start.sh local
The start.sh script will:
- Validate environment and dependencies
- Start PostgreSQL and Redis in Docker (if needed)
- Run database migrations
- Generate Prisma client
- Start the development server
Option 2: Manual Setup
If you prefer to set up manually:
# Backend (from projects/fss/backend)
cd projects/fss/backend
npm install
cp .env.example .env
# Edit .env with your configuration
npx prisma migrate dev
npx prisma generate
npm run start:dev
# Frontend (from projects/fss/frontend in a new terminal)
cd projects/fss/frontend
npm install
cp .env.example .env.local
# Edit .env.local with your API URL
npm run dev
# Mobile (from projects/fss/mobile)
cd projects/fss/mobile
npm install
# Edit src/services/authApi.ts with your backend URL
npx expo start
Verify Installation
After starting, verify your installation by accessing:
| Service | URL | Description |
|---|---|---|
| Frontend | http://localhost:3000 | Next.js application |
| Backend API | https://localhost:3443 | NestJS API |
| API Docs | https://localhost:3443/api | Swagger documentation |
| Health Check | https://localhost:3443/health | Health status |
| Mobile | Expo Developer Tools | Expo dev server |
Default Credentials
After successful installation, you can log in with:
- Email: [email protected]
- Password: Change on first login
warning
Change the default password immediately after first login for security purposes.
Next Steps
Now that you have FSS installed, explore these resources:
Learning Resources
- Installation Guide - Detailed installation steps
- Configuration - Environment setup
- Project Structure - Code organization
Package-Specific Guides
- Frontend Package - Frontend-only setup
- Backend Package - Backend-only setup
- Full Stack Package - Full stack setup
- Mobile Package - iOS/Android setup
Development Resources
- Authentication Guide - Auth system details
- Database Schema - Data models
- Deployment Guide - Production deployment
Troubleshooting
Common Issues
Database Connection Failed
# Make sure PostgreSQL is running
pg_isready -h localhost -p 5432
# Or start PostgreSQL with Docker
docker run -d --name postgres -e POSTGRES_PASSWORD=password -p 5432:5432 postgres:14
Redis Connection Failed
# Make sure Redis is running
redis-cli ping
# Or start Redis with Docker
docker run -d --name redis -p 6379:6379 redis:7
Port Already in Use
# Kill processes using the port
lsof -ti:3000 | xargs kill -9
lsof -ti:3443 | xargs kill -9
Getting Help
If you encounter issues:
- Check the FAQ for common solutions
- Review troubleshooting sections in package READMEs
- Contact support: [email protected]