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)
Installation
-
Clone the repository:
terminalgit 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.
terminalgit 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.
terminalgit remote remove origin
-
Install dependencies:
terminalnpm install
-
Environment Variables: (optional) Copy the required variables from
.env.example
to.env.local
and update the values.terminalcp .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:
terminalnpm 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:
terminalnpm run build
This command compiles the application for production usage.
Additional Scripts
-
Prepare Husky for Git hooks:
terminalnpm run prepare
-
Validate the code with Linting, Formatting & Typecheck:
terminalnpm 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)
terminalgit remote remove origin
-
Stage, commit, and push your code
terminalgit add . git commit -m "<commit-message>" git remote add origin <your-repository-url> git branch -M main git push -u origin main
Repo Structure
BuilderKit includes a primary NextJS Base Boilerplate and 20+ pre-built AI tools. Each boilerplate and app is located in different branches of the GitHub repository.
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
The file structure for the NextJs Boilerplate and the AI Tools is explained respectively.