Get Started

Hola builder, welcome to BuilderKit.ai!

Here is a quick overview of the boilerplate to get it running within a few minutes. You can also go through the deployment tutorial to deploy it on Vercel.

Pre-requisites

Ensure you have the following installed:

Node.js (v14 or higher)
npm, pnpm, or yarn (npm for me)

Repo Structure

BuilderKit includes a primary NextJS Base Boilerplate and 15+ pre-built AI tools. Each boilerplate and app is located in different branches of the GitHub repository.

⚠️

IMPORTANT: Each tool requires its own GitHub branch selection as mentioned below. To use your intended tool successfully, make sure you're working in the correct GitHub branch first.

Below is the list of AI tools and their respective GitHub branches.

Main: The base boilerplate is located in the main branch itself. You can find all the included features here.

NextJS Boilerplate - main

Tool Specific: The AI tools are located in specific branches as listed below.

AI Content Writer Tool - content-writer
MultiLLM ChatGPT Tool - multillm-chatgpt
AI Chat with PDF Tool - chat-with-pdf
Voice Transcription Tool - voice-transcription
Headshot Generator Tool - headshot-generator
Image Generation Tool - image-generation
AI QR Code Generator Tool - qr-code-generation
Interior Design Generator Tool - interior-design-generator
AI YouTube Content Generator Tool - youtube-content-generator
AI Image Enhancer & Upscaler Tool - image-enhancer-upscaler
Chat with YouTube Tool - chat-with-youtube
Text to Speech - text-to-speech
Llama 3.1 ChatGPT - llamagpt
Music Generator - music-generator
DeepSeek Chat App - deepseek-chat

Click on any tool name to access its comprehensive documentation, which includes complete instructions for running and deploying the app.

The file structure for the NextJs Boilerplate and the AI Tools is explained respectively.

Installation

Clone the repository:
terminal
```
git clone https://github.com/1811-Labs-LLC/BuilderKit-Starter.git [YOUR_APP_NAME]
 
cd [YOUR_APP_NAME]
```
If you are trying to run an AI app (e.g., content-writer), switch to that particular branch of the app. Follow the app-specific tutorial for more details.

You can find all the branches available here.
terminal
```
git checkout [BRANCH_NAME]
```
Additionally, to delete the reference to the remote repository, run the following command. Remember that you will not be able to switch to any other branches (apps) once you run this command.
terminal
```
git remote remove origin
```
Install dependencies:
terminal
```
npm install
```
Environment Variables: (optional) Copy the required variables from .env.example to .env.local and update the values.
terminal
```
cp .env.example .env.local
```
Or, manually create a .env.local file in the root directory and add the required environment variables mentioned in .env.example.

Running the Application

Run the development server:
terminal
```
npm run dev
```
Hurray 🎉, your development server is up & running. Open http://localhost:3000 (opens in a new tab) to see your site.
Build for production:
terminal
```
npm run build
```
This command compiles the application for production usage.

Additional Scripts

Prepare Husky for Git hooks:
terminal
```
npm run prepare
```
Validate the code with Linting, Formatting & Typecheck:
terminal
```
npm run validate
```

Upload your project in GitHub

Go to this url to create a new repository (opens in a new tab) in your GitHub account
Run the follwing command to remove the remote origin from BuilderKit (if not already done)
terminal
```
git remote remove origin
```

Stage, commit, and push your code

terminal

git add .
git commit -m "<commit-message>"
git remote add origin <your-repository-url>
git branch -M main
git push -u origin main

📋 NextJS Boilerplate