Getting Started
Quick Start Guide

Quick Start Guide

Welcome to MetaJob – a powerful job board solution powered by Next.js & Strapi. This guide will walk you through installing the public version and optionally unlocking the premium theme using a private token.


✅ Prerequisites

Ensure you have the following installed:

  • Node.js v20 or higher
  • pnpm (recommended)

You'll also need accounts for the following services:

Cloudinary – for media/file uploads
👉 https://cloudinary.com (opens in a new tab)

Brevo (formerly Sendinblue) – for sending transactional emails
👉 https://www.brevo.com (opens in a new tab)

📦 Install pnpm globally:

npm install -g pnpm

🚀 Installation Steps

1. 📁 Clone the Repository

Clone the repository: MetaJob GitHub Repo (opens in a new tab)


2. 🛠 Configure Environment Variables

🔄 Rename Environment Files

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

Make sure to fill in any required values in both .env files.


3. 📦 Install Dependencies

You can install dependencies without needing any token at this stage: Run the following command in the root directory of the project:

pnpm install

4. ⚙️ Run the Backend (Strapi)

pnpm -F backend dev

Visit the Strapi admin at 🔗 http://localhost:1337/ (opens in a new tab)

🔑 Generate an API Token

  1. Create an admin account.
  2. Go to Settings → API Tokens.
  3. Create a Full Access Token.
  4. Add the token to the root .env file:

5. 💻 Run the Frontend (Next.js)

Rename the example environment file for the frontend:

mv example.env -> .env

add all the env including recently created API token.

Then run the frontend:

pnpm -F core dev

Frontend available at 🔗 http://localhost:3000/ (opens in a new tab)


6. Install the Premium Theme

To access the premium UI theme, you'll need a valid access token. Request access by emailing us at info@jstemplate.net. Once you have your token, follow these steps:

🔒 Set Up Private Registry

npm config set @jstemplate:registry=https://api.keygen.sh/v1/accounts/88de7a21-b541-48e5-8727-f992ebeb43fa/artifacts/
npm config set "//api.keygen.sh/v1/accounts/88de7a21-b541-48e5-8727-f992ebeb43fa/artifacts/:_authToken" "$NPM_TOKEN"

To avoid hardcoding, use an env var:

npm config set @jstemplate:registry 'https://api.keygen.sh/v1/accounts/88de7a21-b541-48e5-8727-f992ebeb43fa/artifacts/'
npm config set '//api.keygen.sh/v1/accounts/88de7a21-b541-48e5-8727-f992ebeb43fa/artifacts/:_authToken=${NPM_TOKEN}'

🛠 Install Theme with Token

After setting your token, reinstall dependencies:

pnpm install @jstemplate/metajob-theme