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
Once everything is set up, you're ready to install project dependencies:
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
- Create an admin account.
- Go to Settings → API Tokens.
- Create a Full Access Token.
- 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 frontend dev
Frontend available at 🔗 http://localhost:3000/ (opens in a new tab)
6. 📥 Import Demo Data (Optional)
Now that your backend and frontend are ready, it's time to import the demo data.
You will find the demo data zip file inside apps/backend
, named metajob-import.tar.gz.
-
Navigate to your
apps/backend
folder. -
Run the following command:
pnpm strapi import -f metajob-import.tar.gz --exclude files
This will import the dummy data.
- Reload the frontend, and you should see the full site ready with dummy data.
⚠️ If the frontend does not load the data, simply delete the .next
folder and rerun the project.
If you face any issues during installation, please send an email to info@jstemplate.net.