Installation

This guide will walk you through installing Jubiloop and all its dependencies.

Clone the Repository

First, clone the Jubiloop repository to your local machine:

git clone <repository-url>
cd jubiloop

The repository URL is available in GitHub. Get it from the team lead if you don't have access yet.

Install Dependencies

Jubiloop uses Turborepo with pnpm workspaces to manage dependencies across the monorepo. Install all dependencies with a single command:

pnpm install

This command will:

• Install dependencies for all applications (webapp, server, marketing)
• Install dependencies for all shared packages
• Set up Husky git hooks for code quality enforcement
• Configure the monorepo workspace links

What Happens During Installation

Dependency Installation

The installation process installs dependencies across the entire monorepo structure:

jubiloop/
├── apps/
│   ├── server/            # AdonisJS API backend dependencies
│   ├── webapp/            # React frontend dependencies
│   └── marketing/         # Next.js marketing site dependencies
├── packages/              # Shared package dependencies
│   ├── eslint-config/
│   ├── typescript-config/
│   ├── ui/
│   └── vitest-config/

Husky Git Hooks

Husky will automatically set up git hooks that:

• Format code before commits using Prettier
• Run ESLint checks on staged files
• Ensure code quality standards are maintained

Troubleshooting Installation

Common Issues

pnpm Install Fails

If pnpm install fails, try:

# Clear pnpm cache
pnpm store prune

# Delete node_modules and pnpm-lock.yaml
rm -rf node_modules pnpm-lock.yaml
rm -rf apps/*/node_modules packages/*/node_modules

# Reinstall
pnpm install

Permission Errors

On macOS/Linux, if you encounter permission errors:

# pnpm typically does not have permission issues like npm.
# If needed, ensure your Node.js installation has correct permissions.
# See: https://pnpm.io/installation

Node Version Issues

Ensure you're using Node.js v24 or later:

# Check current version
node --version

# If using nvm, switch to v24
nvm install 24
nvm use 24

Verify Installation

After installation completes, verify everything is set up correctly:

# Check if all workspaces are linked
pnpm ls --depth=0

# Verify Turborepo is installed
pnpm exec turbo --version

# Check git hooks are installed
ls -la .husky/

---

Next: Local Development Setup — set up Docker Stack + HTTPS