Getting Started
Quick Start Guide

Quick Start Guide

Welcome! This guide will walk you through installing and setting up MetaJob, a job board solution powered by Next.js & Strapi.

🔹 Before You Start: You need a valid license and a private NPM key to install MetaJob’s backend and UI theme.

📌 Get your license here:
👉 Metajob - Job Board App with Next.js & Strapi (opens in a new tab)


Prerequisites

Ensure you have the following installed:

  • Node.js v20 or higher
  • pnpm (Recommended for managing dependencies)

📌 Install pnpm globally:

npm install -g pnpm

Installation Steps

Download the Code Files

If you purchased MetaJob from JS Template, you will receive the complete codebase and a license activation token directly via email.

If you purchased from ThemeForest, please email us to request your activation token for installation and setup.

A valid license token is required to run the project.

Before getting started, make sure you have:
MetaJob Codebase (full project files)
License Activation Token

Open the project in your preferred code editor (e.g., VS Code (opens in a new tab))

🔧 Configuring Environment Variables

To set up your environment variables, follow these steps:

Rename the Example Environment File

In the root of your project, locate the example.env file and rename it to .env.

mv example.env .env

Set Up Backend Environment Variables

Navigate to the backend directory and rename the environment file:

mv apps/backend/example.env apps/backend/.env

Add your license token to the root of .env file:

export LICENSE_TOKEN="Your_License_Token_Here"

Create an .npmrc File

In your project root, create an .npmrc file and add the following content:

@js-template:registry=https://api.keygen.sh/v1/accounts/88de7a21-b541-48e5-8727-f992ebeb43fa/artifacts/
//api.keygen.sh/v1/accounts/88de7a21-b541-48e5-8727-f992ebeb43fa/artifacts/:_authToken=$LICENSE_TOKEN

Alternatively, you can export the license token directly in your terminal:

export LICENSE_TOKEN="Your_License_Token_Here"

Install Dependencies

Once everything is set up, you're ready to install project dependencies:

pnpm install

Now, you're all set to run the project! 🚀

🚀 Running the Project

Before starting the frontend, make sure the backend is running first to avoid connection issues.


Start the Backend (Strapi API Server)

Run the following command to start the Strapi backend:

pnpm -F backend dev

Once started, you can access the Strapi Admin Panel at:
🔗 http://localhost:1337/ (opens in a new tab)

🔑 Generate an API Access Token

  1. Create an admin account in Strapi.
  2. Navigate to Settings → API Tokens.
  3. Generate a new Full Access API Token.
  4. Copy this token and add it to your root .env file:
export STRAPI_API_TOKEN="Your_Generated_Token_Here"

Start the Frontend (Next.js UI)

Once the backend is up and configured, start the Next.js frontend:

pnpm -F core dev

Your frontend will now be available at:
🔗 http://localhost:3000/ (opens in a new tab)

Now, you're ready to explore MetaJob! 🚀