feat: add new bootstrap command and update docs#6390
Conversation
This streamlines the new-repo experience by automating some tasks in a `mise run bootstrap` command.
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
There was a problem hiding this comment.
ℹ️ No critical issues — two minor observations, both non-blocking.
Reviewed changes — a new mise run bootstrap task that automates toolchain install, env-file creation, Depot credential injection, and GitHub app setup, plus the docs and supporting task/example updates that hang off it.
- Add
.mise/tasks/bootstrap— installs the toolchain, prompts for a Depot token, createsweb/apps/dashboard/.envanddev/.env.depotfrom their examples, injects the token intoUNKEY_DEPOT_TOKEN+UNKEY_REGISTRY_PASSWORD,chmod 600s the depot file, and runsgo run . dev github setup. Guards existing env files behind a y/N prompt. - Trim
dev/.env.depot.example— from five keys toUNKEY_DEPOT_TOKEN+UNKEY_REGISTRY_PASSWORDwithdepot_...placeholders. Verified the droppedUNKEY_BUILD_S3_*keys are not consumed from.env.depot— Tilt'sdepot-credentialssecret andkrane/ctrl-workeronly read the two remaining keys. - Drop
validate_depot_tokenfromdev/setup-build-backend.sh— removes thedepot_org_prefix enforcement so personaldepot_...tokens are accepted. .mise/tasks/dashboard—dependsnow includesbuild, and thetest -f .env || cp ...template .envself-heal line is removed..mise/tasks/dev— addsraw=truefor TTY passthrough totilt up;.mise/tasks/builddeclaresoutputs=["./bin/unkey"].- Docs
development.mdx— moves "Configure Depot" ahead of Bootstrap and replaces the manualmise installstep withmise run bootstrap.
ℹ️ Stale .env.template reference in Makefile after deletion
web/apps/dashboard/dev/.env.template no longer exists in the tree, but Makefile:141 still runs test -f web/apps/dashboard/.env || cp web/apps/dashboard/dev/.env.template web/apps/dashboard/.env. Anyone invoking that target hits a copy of a missing file. Makefiles are legacy per AGENTS.md, so this is low-priority cleanup rather than a blocker.
Technical details
# Stale `.env.template` reference in `Makefile`
## Affected sites
- `Makefile:141` — `cp web/apps/dashboard/dev/.env.template web/apps/dashboard/.env`, but the source file was deleted (only `web/apps/dashboard/dev/.env.example` remains).
## Required outcome
- The Makefile no longer references a path that does not exist, OR the legacy Makefile target is removed entirely if it is truly dead.
## Suggested approach (optional)
Point the line at `web/apps/dashboard/dev/.env.example`, or delete the target if the Makefile is no longer a supported entry point.Claude Opus | 𝕏
mcstepp
left a comment
There was a problem hiding this comment.
nice
one minor non-blocking suggestion:
since dashboard lost its self-healing task, if you run mise run dashboard without bootstrap first, you get a really weird unhelpful error message. would be nice to mention "did you run bootstrap first?" in the error

This streamlines the new-repo experience by automating some tasks in a
mise run bootstrapcommand.Follow the guide at docs/engineering/contributing/local/development.mdx