docs(default): add example default environments - #99
Merged
Merged
Conversation
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Automations to automatically generate PRs for you. |
djsauble
force-pushed
the
claude/charming-fermat-syut2t
branch
from
September 25, 2026 17:37
c2da8fd to
930b07e
Compare
tanjadev
reviewed
Sep 28, 2026
| That makes it the right home for tools you use everywhere: | ||
|
|
||
| - General-purpose command-line tools, such as `git`, `curl`, and `jq` | ||
| - Your editor, terminal multiplexer, and shell prompt |
Contributor
There was a problem hiding this comment.
Maybe it's worth it adding a 1-2 examples for each tool in parenthesis?
tanjadev
reviewed
Sep 28, 2026
| - General-purpose command-line tools, such as `git`, `curl`, and `jq` | ||
| - Your editor, terminal multiplexer, and shell prompt | ||
| - Coding agents, such as Claude Code and Codex | ||
| - CLIs for services you use across projects, such as cloud providers and GitHub |
Contributor
There was a problem hiding this comment.
also here we could recommend aws-cli and such
tanjadev
approved these changes
Sep 28, 2026
| gnused.pkg-path = "gnused" | ||
| gnused.systems = ["aarch64-darwin"] | ||
| gnutar.pkg-path = "gnutar" | ||
| gnutar.systems = ["aarch64-darwin"] |
Contributor
There was a problem hiding this comment.
off-topic:
I wish we had a possibility to group packages by system..
Add a tutorial page with four example default environments, and guidance on what belongs in a default environment versus a project environment. Each example shows a different part of the manifest: - Everyday essentials: plain [install], built with flox install - Shell power user: [vars] and per-shell [profile] integrations - macOS and Linux: per-package systems for OS-specific tools - Team baseline: [include] a FloxHub environment, then add personal tools The examples don't set options.systems, since the default (aarch64-darwin, aarch64-linux, and x86_64-linux) already covers them, and they don't use the deprecated x86_64-darwin. Link to the page from the default environment tutorial, the Homebrew migration guide, and the layering tutorial, add it to the nav, and regenerate llms.txt. Refs: DEV-29 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
djsauble
force-pushed
the
claude/charming-fermat-syut2t
branch
from
September 28, 2026 21:50
930b07e to
0a8b181
Compare
This branch was successfully deployed
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
2 participants
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.
Summary
Adds a new tutorial page, Example default environments (
tutorials/default-environment-examples.mdx). It answers a common question: "What should go in my default environment?"The page starts with guidance on what belongs in a default environment and what belongs in a project environment. It then gives four manifests you can copy. Each one shows a different part of the manifest:
[install], built withflox install[vars]and per-shell[profile]integrationssystemsfor OS-specific tools[include]a FloxHub environment, then add personal toolsNone of the examples set
options.systems, because the default (aarch64-darwin,aarch64-linux, andx86_64-linux) already covers them. The macOS and Linux example narrows individual packages with per-packagesystems, and uses only non-deprecated systems.Other changes
tutorials/default-environment.mdx: new Deciding what to install section that links to the examplestutorials/migrations/homebrew.mdx: links to the examples from the section on what belongs in the default environmenttutorials/layering-multiple-environments.mdx: adds the examples to Where to nextdocs.json: adds the page to the nav, after the default environment tutorialllms.txt: regenerated with the new entryFixes DEV-29
🤖 Generated with Claude Code