Building from Source

Build zer0 browser from source code for development or custom deployments.

---

📋 Prerequisites

• Node.js 16+

• Git

• Tor Expert Bundle for your platform

• 4 GB RAM minimum

---

🚀 Quick Build

# Clone repository
git clone https://github.com/BrowserZer0/Zer0.git
cd Zer0

# Install dependencies
npm install

# Download Tor binary
# Windows: Place tor.exe in ./resources/win/Tor/
# Linux/Mac: Place tor in ./resources/lin/

# Run development mode
npm run electron-dev

# Build production
npm run build-win    # Windows
npm run build-mac    # macOS
npm run build-linux  # Linux

---

📁 Project Structure

zero_browser/
├── public/              # Electron main process
│   ├── electron.js     # Main entry
│   ├── preload.js      # Preload scripts
│   └── functions/      # Tor, updater, etc.
├── src/                # React UI
│   ├── components/     # UI screens
│   └── electron-tabs/  # Tab implementation
└── dist/              # Build output

---

🔧 Development

# Start dev server
npm start

# Run with Electron
npm run electron-dev

# Run tests
npm test

# Lint code
npm run lint

---

📦 Build Scripts

{
  "electron-dev": "concurrently \"npm start\" \"electron .\"",
  "build-win": "electron-builder build --win",
  "build-mac": "electron-builder build --mac",
  "build-linux": "electron-builder build --linux"
}

---

🐛 Troubleshooting

Tor not found:

• Download from torproject.org

• Place in correct resources/ folder

Build fails:

• Clear node_modules: rm -rf node_modules && npm install

• Update Node: Use v16 or later

Electron won't start:

• Check port 3000 is free

• Try: npm run electron-dev

---

📚 Next Steps

• Project Structure

• Agent SDK

• Contributing Guide

---

Need help? Join our Discord or email [email protected]