README.md

BlueBuild Workshop

Tinkering with your OS through a webapp, how exciting!

Development

Set up environment

Using the Nix Flake:

nix develop

# use this command if in a non-posix-compliant shell
bash -c "SHELL=bash nix develop"

Using the dev toolbox container image:

distrobox create -i ghcr.io/blue-build/workshop-dev -n workshop-dev -p # add --nvidia flag if using nvidia
distrobox enter workshop-dev

The container image can also be used with the just command just pnpm, which runs pnpm inside the container. All commands below are supported in the container.

Install deps

pnpm install

Run development version

SSR web version

pnpm dev

Tauri app

pnpm tauri dev

Recommended IDE Setup

VS Code + Svelte + Tauri + rust-analyzer.

GitHub OAuth

For testing features requiring GitHub OAuth, create a .env file with the GITHUB_CLIENT_ID abd GITHUB_CLIENT_SECRET of your development OAuth app. The callback URL should be http://localhost:5173/api/login/callback.

Building

Build SSR web version

pnpm build

Build Tauri app

pnpm tauri build