admin-boil

Get Started

Step-by-step guide to get started with admin-boil and set up your admin dashboard quickly.

Prerequisites

Before you get started, make sure you have the following:

  • Next.js v14.2.3 or higher installed on your machine. You can download it from the official website.
  • shadcn/ui is correctly set up in your project. If not, follow the installation guide to set it up.

Setup Guide

Buy a Plan

Choose a plan that best suits your needs. Click here to buy a plan and unlock all the features admin-boil has to offer.

Run the Install Command

Navigate to your project folder and run the following command in your terminal:

npx admin-boil@latest init

Enter Your Email and API Key

After running the install command, the terminal will ask for**:**

  1. Your registered email address.
  2. Your API key, which you can find on your profile page. API Key Menu

Enter the details when prompted to proceed.

Copy and Paste Your API Key

Log in to your profile page to copy your API key. Paste the key into the terminal when prompted, then press Enter.

Copy API Key

Let the Terminal Work

Once you provide your API key, the terminal will handle the rest. It will download and configure the necessary files to set up your admin dashboard.

Set Up Databases

To enable full functionality, you'll need to configure two databases:

  1. Redis Database
    • Go to Upstash and create a Redis database.
    • Copy the generated key and add it to your .env file like this:
      NEXT_PUBLIC_UPSTASH_REDIS_REST_TOKEN=your-upstash-key
      NEXT_PUBLIC_UPSTASH_REDIS_REST_URL=your-upstash-url
      
  2. PostgreSQL Database
    • Visit Neon and create a PostgreSQL database.
    • Copy the database key and add it to your .env file:
      DRIZZLE_DATABASE_URL=your-neon-key
      

Run Your App

With everything set up, start your app by running the following command in the terminal:

npm run dev

Need Help?

If you run into any issues during the setup process, we've got you covered:

  • Check out our FAQ for answers to common questions.
  • Visit our Support Page for detailed guides and troubleshooting tips.
  • Still stuck? Drop me a mail and I'will try to help you out.

We're here to make sure you have a seamless experience with admin-boil!

On this page