Building from Source

​

Prerequisites

​

Required Tools

• Node.js >= 20
• pnpm 10.22.0 or higher
• Rust (latest stable) - Install via rustup
• Tauri CLI (included in dev dependencies)

​

Platform-Specific Requirements

​

Quick Start

# Clone the repository
git clone https://github.com/0xtbug/zero-limit.git
cd zero-limit

# Install dependencies
pnpm install

# Run in development mode
pnpm run tauri dev

# Build for production
pnpm run tauri build

​

Development Workflow

​

Running the Development Server

# Frontend only (React + Vite dev server)
pnpm run dev

​

Running the Full Desktop App

# Full Tauri application with hot-reload
pnpm run tauri dev

1. Starts the Vite dev server
2. Compiles the Rust backend
3. Launches the desktop application
4. Enables hot-reload for both frontend and backend changes

​

Type Checking and Building Frontend

# Run TypeScript type checking and build frontend bundle
pnpm run build

# Preview the built frontend locally
pnpm run preview

​

Production Build

​

Building the Application

pnpm run tauri build

• src-tauri/target/release/bundle/nsis/*.exe - NSIS installer
• src-tauri/target/release/bundle/msi/*.msi - MSI installer

• src-tauri/target/release/bundle/dmg/*.dmg - DMG image
• src-tauri/target/release/bundle/macos/*.app - Application bundle

• src-tauri/target/release/bundle/deb/*.deb - Debian package
• src-tauri/target/release/bundle/rpm/*.rpm - RPM package
• src-tauri/target/release/bundle/appimage/*.AppImage - AppImage

​

Build Artifacts

• Frontend build: dist/ - Vite-generated static assets
• Rust build: src-tauri/target/ - Compiled Rust binaries and installers

​

Configuration Files

​

Tauri Configuration

• Application metadata (name, version, identifier)
• Window settings (dimensions, title)
• Bundle options (icon, targets)
• Plugin configuration (updater, etc.)

​

Build Commands

• beforeDevCommand: pnpm dev - Runs before dev mode
• beforeBuildCommand: pnpm build - Runs before production build
• devUrl: http://localhost:1420 - Development server URL
• frontendDist: ../dist - Production frontend assets

​

Cargo Configuration

• Tauri core with tray icon support
• Plugins: shell, dialog, fs, updater, process, os
• HTTP client (reqwest), async runtime (tokio)
• Archive handling (zip, tar, flate2)

​

Troubleshooting

​

Common Issues

# Download and install from Microsoft
# https://developer.microsoft.com/en-us/microsoft-edge/webview2/

# Update Rust to latest stable
rustup update stable

# Clear build cache
cd src-tauri
cargo clean

# Use Node >= 20
node --version

# Install correct pnpm version
corepack enable
corepack prepare [email protected] --activate

# Ensure all system dependencies are installed
# See Platform-Specific Requirements above

​

Next Steps