docs(sandbox): document bring your own deps - #708
Open
Coleary005 wants to merge 1 commit into
Open
Conversation
Adds a bring your own deps (BYOD) section to the custom dependencies page and reframes the page around the three ways to add tooling to the sandbox: setup script, tembo.nix, and BYOD. - Comparison table up top so readers can pick an approach. - BYOD: what config the agent reads, how to generate an environment, statuses, building it into projects, and editing/regenerating the flake. - New 'How the approaches combine' section covering the tembo.nix merge (repo tembo.nix wins on conflicts) and setup scripts layering on top. - Existing tembo.nix content kept intact under its own heading. Co-authored-by: Connor <56210769+Coleary005@users.noreply.github.com>
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
Contributor
|
Requesting review from @DarrenBaldwin07 who has experience with the following files modified in this PR:
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds bring your own deps (BYOD) to Custom Dependencies, and reframes the page around the three ways to get tooling into the sandbox instead of just two.
What changed
tembo.nixvs. bring your own deps, with what you write, the scope, and what each is best for.devcontainer.json,.tool-versions/.nvmrc/.python-version/etc., language manifests and lockfiles, existing Nix files)Bring Your Own Deps: <name>generation session and thebuilding/ready/failedstatuses, plus the note that the badge doesn't auto-refreshPATH)flake.locktembo.nix. Each selected repo'stembo.nixis merged into the generated dev shell and wins on conflicts, and setup scripts still run on top, inside the environment.tembo.nixcontent is unchanged, just nested under its own heading.Availability framing
BYOD is currently gated to internal users, org admins, and the Max/Enterprise entitlement, so it is not reachable in production yet. I documented it as early access, not yet enabled for every workspace, with a book-a-call link — matching how
tembo.nixand Projects are already framed on the site. Happy to soften it to internal-only, or hold the section behind a follow-up, if you'd rather it not be public until the feature ships.Verification
mint broken-linkspasses with no broken links.Note
Cursor Bugbot is generating a summary for commit 96c4a3d. Configure here.