Skip to content

Commit 61cd950

Browse files
Jenny MahmoudiJenny Mahmoudi
authored andcommitted
Add Reproducible dev environment use case
1 parent aa87c64 commit 61cd950

File tree

1 file changed

+21
-18
lines changed

1 file changed

+21
-18
lines changed

docs/index.md

Lines changed: 21 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ There are no containers involved, so there's no isolation preventing you from us
3939
---
4040

4141
Install `flox` with `brew` and get your dev
42-
environment set up in minutes
42+
environment set up in minutes.
4343

4444
[:octicons-arrow-right-24: Download & Install][install_flox]
4545

@@ -51,7 +51,7 @@ There are no containers involved, so there's no isolation preventing you from us
5151

5252
---
5353

54-
Flox makes the power of Nix more accessible for your team, and maybe for you too
54+
Flox makes the power of Nix more accessible for your team, and maybe for you too.
5555

5656
[:octicons-arrow-right-24: Install Flox with flakes or profiles](install-flox.md?h=nix#__tabbed_1_6){:target="_blank"}
5757

@@ -68,34 +68,37 @@ Combine multiple languages in a single environment or layer environments for mor
6868

6969
See how to get started with Flox in your language:
7070

71-
<div class="grid cards" markdown>
7271

73-
- :simple-nodedotjs: __Node__ <br>
74-
[Set up a NodeJS environment](https://flox.dev/blog/using-flox-to-create-portable-reproducible-nodejs-environments/)
75-
- :fontawesome-brands-golang: __Go__ <br>
76-
[Set up a Go environment](https://flox.dev/blog/using-flox-to-create-portable-reproducible-go-environments/)
77-
- :fontawesome-brands-python: __Python__ <br>
78-
[Set up a Python environment](https://flox.dev/blog/using-flox-to-create-portable-reproducible-python-environments/)
79-
- :fontawesome-brands-rust: __Rust__ <br>
80-
[Set up a Rust environment](https://flox.dev/blog/using-flox-to-create-portable-reproducible-python-environments/) <br>
81-
- :material-language-ruby: __Ruby__ <br>
82-
[Set up a Ruby environment](https://flox.dev/blog/making-ruby-projects-easier-to-share/)
83-
</div>
72+
[Node :simple-nodedotjs:](https://flox.dev/blog/using-flox-to-create-portable-reproducible-nodejs-environments/){ .md-button }
73+
[Go :fontawesome-brands-golang:](https://flox.dev/blog/using-flox-to-create-portable-reproducible-go-environments/){ .md-button }
74+
[Python :fontawesome-brands-python:](https://flox.dev/blog/using-flox-to-create-portable-reproducible-python-environments/){ .md-button }
75+
[Rust :fontawesome-brands-rust:](https://flox.dev/blog/using-flox-to-create-portable-reproducible-python-environments/){ .md-button }
76+
[Ruby :material-language-ruby:](https://flox.dev/blog/making-ruby-projects-easier-to-share/){ .md-button }
77+
78+
8479

8580
## Why Flox?
8681

87-
...high level overview of use cases, exact titles TBD...
82+
...very high level about same old software problems with increasingly complex solutions...
83+
84+
Flox provides a simpler way to get:
8885

8986
1. Reproducible dev environments
90-
2. Reproducible package manager for your whole system
87+
2. Reproducible package management for any system
9188
3. Consistent builds from local to CI to production
9289

9390
## Reproducible dev environments
9491

95-
..one paragraph description, can include links within to services concepts, sharing, etc...
92+
Set up a [local developer environment](https://flox.dev/docs/tutorials/creating-environments/) that will work the same across multiple system types and architectures. [Activate](https://flox.dev/docs/concepts/activation/) an environment to enter a subshell with the configuration when you need it, then exit to return to use a different version just as quickly.
93+
94+
All the [packages](https://hub.flox.dev/packages), [activation scripts](https://flox.dev/blog/mastering-hooks-and-profiles-for-reproducible-flox-environments/), [environment variables](https://flox.dev/docs/tutorials/creating-environments/#customize-the-shell-hook-and-environment-variables) and [services](https://flox.dev/docs/concepts/services/) needed to reproduce the environment are declared in a simple [manifest](https://flox.dev/docs/concepts/manifest/) that can be checked into [version control along with your source code](https://flox.dev/blog/flox-and-teams-managing-your-code-and-your-runtime-environment-in-just-one-place/).
95+
96+
Once your environment is all set up, you can simplify your project's README to a single command (`flox activate`) to easily [share environments with your team](https://flox.dev/blog/flox-and-teams-using-shared-flox-environments/) or [onboard new developers](https://flox.dev/blog/flox-and-teams-onboarding-made-easy-with-github-and-flox/).
97+
98+
Create a reusable toolchain or templates to bootstrap new projects by [reusing and combining dev environments](https://flox.dev/docs/tutorials/composition/).
9699

97100

98-
## Reproducible package manager for any system
101+
## Reproducible package management for any system
99102

100103
Use Flox to set up your [default environment](https://flox.dev/docs/tutorials/default-environment/) with a set of
101104
packages that you always want available, whether you're on macOS or Linux -- x86 or ARM.

0 commit comments

Comments
 (0)