Installation
Step-by-step guide to create your new project
Installation
Get your build-elevate project up and running in minutes.
Prerequisites
Before you begin, make sure you have the following installed on your system:
Node.js 20+
Download from nodejs.org
pnpm (Recommended)
Fast, disk space efficient package manager
Verify Your Installation
Check that Node.js is installed correctly:
node --version
# Should output: v20.x.x or higherWhile pnpm is recommended for its speed and efficiency, you can also use npm or bun. The CLI will detect your preferred package manager during setup.
Create Your Project
Option 1: Interactive Setup (Recommended)
Run the following command and follow the prompts:
npx build-elevate@latest initYou'll be asked:
- Project name - Enter your project name (e.g.,
my-saas-app) - Package manager - Choose between pnpm, npm, or bun
- Docker - Opt to include Docker configuration
- Prisma Studio - Choose to include Prisma Studio for database management
The CLI will scaffold your entire project structure and install all dependencies. This usually takes 2-3 minutes.
Option 2: Direct Installation
You can also specify options directly:
pnpm dlx build-elevate@latest init my-project -yWhat Gets Created?
After running the command, you'll have this structure:
my-project/
├── apps/
│ ├── web/ # Next.js frontend
│ ├── api/ # Express backend
│ ├── email/ # Email templates
│ └── studio/ # Database UI
├── packages/
│ ├── auth/ # Authentication logic
│ ├── db/ # Prisma & database
│ ├── ui/ # React components
│ ├── email/ # Email templates
│ ├── utils/ # Shared utilities
│ └── rate-limit/ # API rate limiting
├── package.json
├── turbo.json
└── pnpm-workspace.yamlPost-Installation Steps
1. Navigate to Your Project
cd my-project2. Open in Your Editor
code . # VS Code
# or
cursor . # Cursor3. Review the Files
Take a moment to explore:
README.md- Project overview and commandsturbo.json- Turborepo pipeline configurationpackage.json- Available scripts and dependencies
Environment Configuration
Before running the project, you need to configure environment variables. We'll cover this in detail in the next section.
Next: First Steps
Configure environment variables and run your project
Environment Variables Reference
Complete guide to all environment variables
Alternative Installation Methods
Clone the Repository
If you want to contribute or explore the source code:
# Clone the repository
git clone https://github.com/vijaysingh2219/build-elevate.git
# Navigate to the directory
cd build-elevate
# Install dependencies
pnpm install
# Copy environment files
cp apps/web/.env.example apps/web/.env.local
cp apps/api/.env.example apps/api/.env.local
cp packages/db/.env.example packages/db/.envUse as Template
You can also use it as a GitHub template:
- Visit github.com/vijaysingh2219/build-elevate
- Click "Use this template"
- Create your repository
- Clone and install dependencies
Quick tip: Run pnpm dev from the root to start all applications
simultaneously. We'll cover this in detail in the next section.