Building

​

Development Builds

​

Frontend Only (Vite)

pnpm dev

• Vite dev server on http://localhost:1420
• Hot module replacement (HMR)
• Fast refresh for React components

​

Full Tauri App

pnpm tauri dev

pnpm tauri:dev

• Vite dev server on port 1420
• Rust backend with debug logging
• Native app window
• Hot-reload for frontend changes
• Auto-restart on Rust changes

​

Production Builds

​

Frontend Build

pnpm build

1. TypeScript compiler (tsc)
2. Vite production build
3. Outputs to dist/

• dist/index.html - Main window
• dist/pill.html - Recording pill window
• dist/toast.html - Toast notifications
• dist/assets/ - Bundled JS/CSS

​

Full Native Build

pnpm tauri build

1. Builds frontend (TypeScript + Vite)
2. Compiles Rust backend
3. Builds platform-specific sidecars
4. Creates native bundle
5. Signs and notarizes (macOS)

• src-tauri/target/release/bundle/macos/VoiceTypr.app
• src-tauri/target/release/bundle/dmg/VoiceTypr_*.dmg

• src-tauri/target/release/bundle/msi/VoiceTypr_*.msi
• src-tauri/target/release/VoiceTypr.exe

​

Platform-Specific Builds

​

macOS Builds

pnpm tauri dev --config src-tauri/tauri.macos.conf.json

pnpm tauri build --target aarch64-apple-darwin

pnpm tauri build --target universal-apple-darwin

• Requires Xcode Command Line Tools
• Swift sidecar auto-builds via build.rs
• Code signing requires Apple Developer ID
• Notarization requires app-specific password

​

Windows Builds

pnpm tauri build --target x86_64-pc-windows-msvc

pnpm tauri build --target aarch64-pc-windows-msvc

• x64 builds include Vulkan GPU acceleration
• ARM64 builds use CPU-only Whisper
• Code signing requires Windows certificate

​

Sidecar Builds

​

Parakeet Swift Sidecar (macOS)

pnpm sidecar:build

cd sidecar/parakeet-swift
bash build.sh release

• sidecar/parakeet-swift/dist/parakeet-sidecar-aarch64-apple-darwin

1. build.rs triggers on cargo build
2. Runs sidecar/parakeet-swift/build.sh
3. Compiles Swift with swift build -c release --arch arm64
4. Copies binary to dist/ with platform suffix
5. Tauri bundles it into the app

​

FFmpeg Sidecar

pnpm sidecar:ensure-ffmpeg

• Audio format conversion
• Cross-platform audio processing

​

Build Configurations

​

Development Config

{
  "build": {
    "devPath": "http://localhost:1420",
    "beforeDevCommand": "pnpm dev"
  }
}

​

Production Config

{
  "build": {
    "distDir": "../dist",
    "beforeBuildCommand": "pnpm build"
  }
}

​

CI/CD Builds

pnpm ci:mac

pnpm ci:win

pnpm ci:win:full

• ci-local-macos.sh - macOS quality checks + build
• ci-local-windows.ps1 - Windows quality checks + build

​

Build Optimization

​

Release Optimizations

[profile.release]
opt-level = 3
lto = true
codegen-units = 1
panic = 'abort'

​

Bundle Size

• Rust binary: ~25MB
• Frontend assets: ~5MB
• Parakeet sidecar: ~1.2MB
• FFmpeg sidecar: ~90MB

• Executable: ~30MB
• Frontend assets: ~5MB
• FFmpeg sidecar: ~65MB

​

Reducing Build Time

1. Use cargo build cache:
   # First build: 8-10 minutes
   # Incremental: 30-60 seconds
   
2. Frontend-only mode for UI work:
   pnpm dev  # Skip Rust compilation
   
3. Parallel builds with -j flag:
   cargo build --release -j$(nproc)
   

​

Troubleshooting

​

Build Fails with FFmpeg Error

pnpm sidecar:ensure-ffmpeg

​

Swift Sidecar Build Fails (macOS)

swift --version
xcode-select --install

​

Vulkan Link Error (Windows)

• Visual Studio 2019 or later
• “Desktop development with C++” workload

​

Tauri Build Hangs

cd src-tauri
cargo clean
cd ..
pnpm tauri build

​

Next Steps

• Run tests before building
• Follow code style guidelines
• Read contributing guide for releases