Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/0xchriswilder/journey/llms.txt

Use this file to discover all available pages before exploring further.

​
Get Started in 3 Steps

This quick start guide will have you running the FHEVM Bootcamp platform on your local machine in minutes.
1

Clone the Repository

First, clone the bootcamp repository to your local machine:
git clone https://github.com/your-org/fhevm-bootcamp.git
cd fhevm-bootcamp
Replace your-org/fhevm-bootcamp with the actual repository URL for your bootcamp instance.
2

Install Dependencies

Install all required Node.js dependencies using npm:
npm install
The bootcamp uses these key dependencies:Frontend Framework:
  • react@18.3.1 - UI library
  • vite@5.4.19 - Build tool and dev server
  • typescript@5.8.3 - Type safety
UI Components:
  • @radix-ui/* - Accessible component primitives
  • tailwindcss@3.4.17 - Utility-first CSS
  • lucide-react@0.462.0 - Icon library
Blockchain Integration:
  • wagmi@2.16.9 - React hooks for Ethereum
  • @rainbow-me/rainbowkit@2.2.8 - Wallet connection
  • ethers@6.15.0 - Ethereum library
  • viem@2.37.6 - TypeScript Ethereum utilities
FHE Libraries:
  • fhevmjs@0.6.2 - Client-side FHE operations
  • @zama-fhe/relayer-sdk@0.2.0 - Decryption relayer
State & Routing:
  • zustand@5.0.8 - State management
  • react-router-dom@6.30.1 - Routing
  • @tanstack/react-query@5.83.0 - Data fetching
Installation typically takes 1-3 minutes depending on your internet connection. The total package size is approximately 350MB.
3

Start the Development Server

Launch the Vite development server:
npm run dev
You should see output like:
VITE v5.4.19  ready in 342 ms

➜  Local:   http://localhost:8080/
➜  Network: http://192.168.1.100:8080/
➜  press h + enter to show help

​
What’s Next?

After launching the bootcamp, you’ll see the Dashboard page with:

Week Overview

Browse all 4 weeks of curriculum with objectives and lesson lists

Progress Tracking

Monitor your completion status across lessons and weeks

Instructor Mode

Toggle instructor notes and teaching guidance (top-right corner)

Resources Library

Access contract examples, code templates, and reference materials

​
Exploring the Platform

The bootcamp uses a sidebar navigation structure:
  • Dashboard - Landing page with curriculum overview
  • Week 1-4 - Expandable accordion with lessons and homework
  • Progress - Analytics dashboard showing your completion
  • Contracts - Library of FHEVM contract examples
  • Resources - Additional learning materials
  • Instructor - Teaching guide (if in instructor mode)
Click the menu icon in the top-left to collapse/expand the sidebar for more screen space.

​
Starting Your First Lesson

1

Navigate to Week 1

In the sidebar, click on “Week 1: Foundations of Confidential Computing” to expand it.
2

Open Lesson 1.1

Click on “Lesson 1.1: Welcome to FHEVM” to open the first lesson.
3

Complete the Lesson

Read through the content sections, complete the quiz at the end, and mark the lesson as complete.Your progress will be automatically saved to browser localStorage.

​
Available Scripts

The bootcamp provides these npm scripts for different tasks: 
# Start the development server (port 8080)
npm run dev

​
Script Details

ScriptCommandDescription
devviteStarts development server on port 8080 with hot module replacement
buildvite buildCreates production build in dist/ folder
build:devvite build --mode developmentDevelopment mode build with source maps
build:slidesnpx @marp-team/marp-cli ...Generates HTML slides from markdown presentations
linteslint .Runs ESLint to check code quality
previewvite previewPreviews production build locally

​
Configuration Overview

The bootcamp runs out-of-the-box with sensible defaults, but you can customize it:

​
Environment Variables (Optional)

Create a .env file in the root directory to customize settings:
.env
# Network Configuration
VITE_RPC_URL=https://devnet.zama.ai
VITE_CHAIN_ID=8009
VITE_NETWORK_NAME=Zama Devnet

# Use mock FHE client for tutorials (true/false)
VITE_USE_MOCKS=true

# App Metadata
VITE_APP_NAME=FHEVM Developer Bootcamp
VITE_APP_DESCRIPTION=Learn confidential computing on Zama Protocol
The .env file is optional for local development. The bootcamp includes a .env.example template you can copy and modify.

​
Vite Configuration

The platform is configured via vite.config.ts:
vite.config.ts
import { defineConfig } from "vite";
import react from "@vitejs/plugin-react-swc";
import { nodePolyfills } from "vite-plugin-node-polyfills";

export default defineConfig({
  server: {
    host: "::",
    port: 8080,  // Development server port
  },
  plugins: [
    react(),
    nodePolyfills({
      // Polyfills for fhevmjs compatibility
      include: ["buffer", "process", "util", "events", "stream"],
      globals: { Buffer: true, global: true, process: true },
    }),
  ],
  resolve: {
    alias: {
      "@": path.resolve(__dirname, "./src"),  // @ imports
    },
  },
});

​
Verifying Your Installation

To ensure everything is working correctly:
1

Check the Dashboard Loads

Navigate to http://localhost:8080 and verify the dashboard displays all 4 weeks.
2

Open a Lesson

Click into any lesson and confirm content renders properly with syntax highlighting.
3

Test Progress Tracking

Complete a lesson and check that your progress persists after refreshing the page.
4

Check Console

Open browser DevTools (F12) and verify there are no critical errors in the console.

​
Common Quick Start Issues

If port 8080 is occupied, you can change it in vite.config.ts:
server: {
  host: "::",
  port: 3000,  // Change to any available port
},
Or specify a different port when running:
npm run dev -- --port 3000
This bootcamp requires Node.js 18.x or higher. Check your version:
node --version
If you’re running an older version, upgrade using nvm or download from nodejs.org.
Try clearing npm cache and reinstalling:
rm -rf node_modules package-lock.json
npm cache clean --force
npm install
  1. Check the browser console (F12) for specific errors
  2. Ensure you’re using a modern browser (Chrome, Firefox, Edge, Safari 14+)
  3. Try clearing browser cache and hard reload (Ctrl+Shift+R or Cmd+Shift+R)
  4. Verify the dev server is still running in your terminal

​
Next Steps

Now that your bootcamp is running:

Detailed Installation

Learn about prerequisites, environment setup, and advanced configuration

Curriculum Overview

Explore the full 4-week curriculum structure and learning objectives

Start Week 1

Begin your journey with Lesson 1.1: Welcome to FHEVM

Instructor Guide

Learn how to run this bootcamp for your community (for educators)
Pro tip: Enable dark mode using the theme toggle in the top-right corner for a more comfortable learning experience.

Build docs developers (and LLMs) love

Get started for freeTalk to us