`mix_workspace`

Native Mix project seed.

Description#

mix_workspace evaluates mix.exs for development, test, and production, then emits ordinary mix_dependencies, mix_project, elixir_test, and mix_release targets. The native manifest and lockfile stay authoritative.

For a leaf project, the seed's build capability selects the development application. For an umbrella root, it selects the detected child mix_workspace seeds. Nested projects and path dependencies preserve their workspace-relative layout.

Projects with external dependencies must already have a current mix.lock and materialized dependency sources. Resolution runs with isolated Mix and Hex homes and Hex offline mode.

Materialize the exact locked sources before previewing or loading the graph:

bash

mix deps.get --check-locked

Use mix deps.get without --check-locked only when intentionally creating or updating the lockfile.

Attributes#

Attribute	Type	Required	Default	Description
`manifest`	string	no	`mix.exs`	Package-relative Mix project manifest
`lockfile`	string	no	`mix.lock`	Package-relative authoritative lockfile
`resolver_inputs`	list<string>	no	`srcs`	Text inputs available while deriving the graph

Dependency Edges#

Edge	Accepts	Description
`deps`	`mix_project`, `mix_workspace`	Default development application or nested workspace selected by the resolver

Providers#

The target emits mix_workspace.

Capabilities#

Capability	Output groups
`build`	none

Direct Use#

Discover and preview the native project:

bash

once query native-projects
once query native-project mix

Initialize the seed:

bash

once edit init-native-project mix

The imported target is equivalent to:

toml

[[target]]
name = "mix"
kind = "mix_workspace"
srcs = ["mix.exs"]

[target.attrs]
resolver_inputs = ["mix.exs", "mix.lock", ".formatter.exs", "config/**/*.exs"]

Sources#

Mix project configuration defines the evaluated project metadata.
Mix tasks define project task behavior.