​

Getting Started with JACoB

There are three main steps to get started with JACoB. This guide will walk you through the process of installing the JACoB AI Bot GitHub application, setting up your JACoB configuration, and installing the JACoB Figma plugin. It usually takes about 5-10 minutes to install and configure.

​

Step 1: Install the JACoB AI Bot GitHub Application

To begin, you need to install the JACoB AI Bot on your GitHub account. This bot will work with your repositories to automate coding tasks, review code, and manage pull requests.

1. Go to JACoB AI Bot GitHub App.
2. Install the application and grant it permission to access the repositories you want to use with JACoB.

​

Step 2: Set Up Your JACoB Configuration

Next, you need to run the JACoB custom setup command to create a jacob.config file in your repository. This configuration file allows JACoB to understand your project’s specific needs and any environment variables essential for building the app.

1. Run the JACoB custom setup command in your project directory and answer the questions. You can always edit this later if needed.

   npx jacob-setup create
   

2. A jacob.config file will be created. Open it and fill in the necessary details to customize it to your project.
3. Be sure to add any .env placeholder variables to the config file, as JACoB will need these to build the application (similar to a CI system). Here’s an example structure:

   {
     "env": {
       "NODE_ENV": "",
       "NEXTAUTH_SECRET": "NEXTAUTH_SECRET",
       "GITHUB_ID": "GITHUB_ID",
       "GITHUB_SECRET": "GITHUB_SECRET",
       "EMAIL_FROM": "EMAIL_FROM",
       "DATABASE_URL": "file:./db.sqlite",
       "NEXTAUTH_URL": "http://localhost:3000"
     }
   }
   

   Note: Ensure that you never commit real secret keys. Use placeholders for standard build variables and replace them with actual values in your secure environment.
4. Commit the jacob.config file to your repository and push it to GitHub.

​

Step 3: Install the JACoB Figma Plugin

JACoB can convert your Figma designs into code, making the design-to-development process smoother.

Install the JACoB Figma plugin from Figma Community.