Installation

Get Fast Forward Dev up and running on your local machine in less than 5 minutes.

Prerequisites

Before you begin, make sure you have the following installed:

Node.js (v18 or higher) - Download here
npm or yarn - Comes with Node.js
Git - Download here
MongoDB - MongoDB Atlas (free tier) or local installation
Stripe Account - Sign up here (free)

Fast Forward Dev consists of two repositories: fast-forward-dev-client (frontend) and fast-forward-dev-server (backend). You’ll need to set up both.

Install Client (Frontend)

Clone the Client Repository

Choose your preferred method (SSH or HTTPS):

SSH


git clone git@github.com:EmilLykke/fast-forward-dev-client.git my-project-client
cd my-project-client

Replace my-project-client with your desired folder name.

Remove Original Git Remote


git remote remove origin

Add Your Own Repository

SSH


git remote add origin git@github.com:YOUR_USERNAME/YOUR_NEW_REPO.git

Push to Your Repository


git push origin master
git branch --set-upstream-to=origin/master master

Install Dependencies


npm install

Set Up Environment Variables


mv .env.local.example .env.local

Edit .env.local and fill in your environment variables. See the Environment Variables guide for details.

Install Server (Backend)

Clone the Server Repository

SSH


git clone git@github.com:EmilLykke/fast-forward-dev-server.git my-project-server
cd my-project-server

Remove Original Git Remote


git remote remove origin

Add Your Own Repository

SSH


git remote add origin git@github.com:YOUR_USERNAME/YOUR_NEW_REPO.git

Push to Your Repository


git push origin master
git branch --set-upstream-to=origin/master master

Install Dependencies


npm install

Set Up Environment Variables


mv .env.example .env

Edit .env and fill in your environment variables. See the Environment Variables guide for details.

Project Structure

After installation, you’ll have two project folders:

Client Structure


my-project-client/
├── src/
│   ├── app/              # Next.js pages (App Router)
│   │   ├── page.tsx      # Home page
│   │   ├── admin/        # Admin pages
│   │   ├── api/          # API routes
│   │   └── auth/         # Auth pages
│   ├── components/       # Reusable components
│   │   ├── Hero/
│   │   ├── Pricing/
│   │   ├── FAQ/
│   │   └── ...
│   ├── config/           # Configuration files
│   │   └── config.ts     # Main config
│   └── utils/            # Helper functions
├── public/               # Static assets
├── .env.local            # Environment variables
└── package.json

Server Structure


my-project-server/
├── src/
│   ├── index.ts          # Server entry point
│   ├── routes/           # API endpoints
│   │   ├── user/         # User routes
│   │   ├── billing/      # Billing routes
│   │   └── stripe/       # Stripe webhooks
│   ├── models/           # Mongoose models
│   │   ├── user.model.ts
│   │   ├── identity.model.ts
│   │   └── billing.model.ts
│   ├── mailersend/       # Email templates
│   └── utils/            # Helper functions
├── build/                # Compiled JavaScript
├── .env                  # Environment variables
└── package.json

Next Steps

Now that you have Fast Forward Dev installed, continue with:

Environment Variables - Set up your API keys and secrets
Running Locally - Start your development servers
Quick Start Tutorial - Build your first feature

Need help? Contact emillykkeg@gmail.com or check the GitHub issues.