Skip to content

feat: add new bootstrap command and update docs#6390

Merged
chronark merged 1 commit into
mainfrom
eng-2881-update-engineering-docs-for-local-setup-gaps
Jun 12, 2026
Merged

feat: add new bootstrap command and update docs#6390
chronark merged 1 commit into
mainfrom
eng-2881-update-engineering-docs-for-local-setup-gaps

Conversation

@chronark

@chronark chronark commented Jun 9, 2026

Copy link
Copy Markdown
Collaborator

This streamlines the new-repo experience by automating some tasks in a
mise run bootstrap command.

Follow the guide at docs/engineering/contributing/local/development.mdx

This streamlines the new-repo experience by automating some tasks in a
`mise run bootstrap` command.
@mintlify

mintlify Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
engineering 🟢 Ready View Preview Jun 9, 2026, 9:01 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@linear-code

linear-code Bot commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

ENG-2881

@vercel

vercel Bot commented Jun 9, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
dashboard Ready Ready Preview, Comment Jun 9, 2026 9:02am
design Ready Ready Preview, Comment Jun 9, 2026 9:02am

Request Review

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ℹ️ 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, creates web/apps/dashboard/.env and dev/.env.depot from their examples, injects the token into UNKEY_DEPOT_TOKEN + UNKEY_REGISTRY_PASSWORD, chmod 600s the depot file, and runs go run . dev github setup. Guards existing env files behind a y/N prompt.
  • Trim dev/.env.depot.example — from five keys to UNKEY_DEPOT_TOKEN + UNKEY_REGISTRY_PASSWORD with depot_... placeholders. Verified the dropped UNKEY_BUILD_S3_* keys are not consumed from .env.depot — Tilt's depot-credentials secret and krane/ctrl-worker only read the two remaining keys.
  • Drop validate_depot_token from dev/setup-build-backend.sh — removes the depot_org_ prefix enforcement so personal depot_... tokens are accepted.
  • .mise/tasks/dashboarddepends now includes build, and the test -f .env || cp ...template .env self-heal line is removed.
  • .mise/tasks/dev — adds raw=true for TTY passthrough to tilt up; .mise/tasks/build declares outputs=["./bin/unkey"].
  • Docs development.mdx — moves "Configure Depot" ahead of Bootstrap and replaces the manual mise install step with mise 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.

Pullfrog  | Fix all ➔Fix 👍s ➔View workflow run | Using Claude Opus𝕏

Comment thread .mise/tasks/dashboard

@perkinsjr perkinsjr left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is smooth as fuck.

@mcstepp mcstepp left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

@chronark chronark added this pull request to the merge queue Jun 11, 2026
@github-merge-queue github-merge-queue Bot removed this pull request from the merge queue due to no response for status checks Jun 11, 2026
@chronark chronark merged commit 37044fc into main Jun 12, 2026
16 of 17 checks passed
@chronark chronark deleted the eng-2881-update-engineering-docs-for-local-setup-gaps branch June 12, 2026 16:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants