|
|
@@ -1,46 +0,0 @@
|
|
|
-# bootstrap
|
|
|
-
|
|
|
-Personal dev environment bootstrap for Debian Linux dev workstation setup.
|
|
|
-
|
|
|
-## What this is
|
|
|
-
|
|
|
-Numbered Bash scripts (`[0-9][0-9]-*.sh`) run in order to install and configure a full dev environment: system packages, Docker, Rust/Go/Node toolchains, Helix editor, tmux, LSP servers, CLI tools.
|
|
|
-
|
|
|
-Each script is independently executable and intended to be idempotent.
|
|
|
-
|
|
|
-## Key commands
|
|
|
-
|
|
|
-| Command | Purpose |
|
|
|
-|---|---|
|
|
|
-| `./test.sh` | Build Docker image and run all scripts inside container (smoke test) |
|
|
|
-| `bash -l <script.sh>` | Run a single bootstrap script (needs `-l` for login shell to pick up `~/.bashrc.d/` additions) |
|
|
|
-| `bash docker-test` | Run all `[0-9][0-9]-*.sh` in order (used inside container) |
|
|
|
-
|
|
|
-## Architecture
|
|
|
-
|
|
|
-The numbered prefix defines execution order and implicit dependencies:
|
|
|
-
|
|
|
-| Prefix | Category |
|
|
|
-|---|---|
|
|
|
-| `00-` | System/distro setup (packages via apt) |
|
|
|
-| `01-` | Language runtimes & core tools (bashrc.d, Docker, Go, Node, Rust) |
|
|
|
-| `02-` | Editor & terminal (Helix, just, tmux) — depends on Rust from `01-rust` |
|
|
|
-| `05-` | LSP servers |
|
|
|
-| `10-` | CLI tools (fzf, Rust apps) — depends on Rust from `01-rust` |
|
|
|
-
|
|
|
-- `00-distro-debian.sh` must run first (base packages for everything else).
|
|
|
-- `01-rust.sh` must precede `02-helix.sh`, `02-just.sh`, `10-rust-apps.sh`.
|
|
|
-- `01-bashrc.d.sh` should run early since several scripts add profile fragments to `~/.bashrc.d/`.
|
|
|
-
|
|
|
-## Testing
|
|
|
-
|
|
|
-- `./test.sh` builds `debian:trixie-slim` based Docker image tagged `bootstrap`, then runs `docker-test` inside it.
|
|
|
-- The Docker test runner executes scripts with `bash -l` (login shell) to ensure PATH additions from `~/.bashrc.d/` are active.
|
|
|
-- No unit tests, lint, format, or CI exist.
|
|
|
-
|
|
|
-## Repo conventions
|
|
|
-
|
|
|
-- No `Makefile`, `Justfile`, `.editorconfig`, `.gitignore`, or linter configs.
|
|
|
-- Scripts use `set -e` in the Docker test runner but not necessarily in individual scripts.
|
|
|
-- All scripts install to user home (`~/.local/`, `~/.bashrc.d/`, etc.) — designed per-user, not system-wide.
|
|
|
-- Remote: `ssh://git@source.ramthun.dev:2222/mike/bootstrap.git` (private), branch `master`.
|
