Developer Setup GUI

A Tauri-based desktop application that bootstraps the FoodTruckNerds workspace. It guides developers through prerequisites, environment configuration, and project installs.

Features

  • Visual setup wizard

  • Prerequisites checks (Node.js/Corepack/pnpm)

  • Project status and health checks

  • Environment file creation and key management

  • PowerShell integration for setup/run tasks

  • Quick links to required services

Quick Start

Windows/macOS/Linux builds are available from releases. To run from source:

cd setup-gui
corepack enable
corepack install
pnpm install
pnpm tauri dev

Prerequisites

  • Rust toolchain (install from https://rustup.rs)

  • Node.js 18+ (for frontend build)

  • pnpm (installed via Corepack)

Architecture

Frontend (React + TypeScript):

  • React 18 + TypeScript

  • Tailwind CSS

  • Lucide React icons

  • Tauri JS API

Backend (Rust):

  • Tauri 2.x

  • Executes PowerShell scripts

  • Filesystem/process integration

Project Structure

onboarding/
├── setup-gui/            # Developer Setup GUI app
│   ├── app/              # Vite app root
│   │   ├── index.html    # HTML shell
│   │   └── src/          # React source
│   ├── src-tauri/        # Tauri (Rust) backend
│   ├── scripts/          # PowerShell helper scripts
│   ├── vite.config.ts    # Vite config (root=app)
│   └── package.json
└── docs/                 # Antora docs (this site)

Usage

  1. Launch the app

  2. Set the project path to the ftn-site-vercel directory

  3. Review prerequisites and required service accounts

  4. Run setup to install dependencies and create env files

  5. Enter API keys; they are saved to your env files

Troubleshooting

  • Node.js not found: install Node.js 22+

  • PowerShell execution policy: run as Administrator or update policy

  • Permission errors: run with appropriate permissions

  • Rust/Tauri CLI missing: cargo install tauri-cli

Related Scripts

See PowerShell scripts for setup.ps1 and run.ps1 details.