mix auix.
Copy Markdown
Finds registered themes along with the configured theme name and generates the Aurora UIX stylesheet in three files (plus two optional host-owned files):
assets/css/auix-variables.css—:root/:root_colorsdeclarations.assets/css/auix-rules.css—.auix-*component rules.assets/css/auix-stylesheet.css— back-compat shim that re-imports only the variables and rules files (Tailwind happy path).
Also copies the daisyUI bridge file (assets/css/auix-bridge-daisyui.css)
on first run. On subsequent runs the bridge is left untouched so host
applications can customise their token mappings freely. Pass --force to
overwrite an existing bridge.
Two opt-in scaffolds are available behind flags: --baseline writes
assets/css/auix-baseline.css (a tag-selector reset for hosts without a
CSS preflight) and --custom writes assets/css/auix-custom.css (a
host-owned override layer). Both are host-owned once created and are not
overwritten unless --force is passed.
Usage
mix auix.gen.stylesheet
mix auix.gen.stylesheet --force
mix auix.gen.stylesheet --baseline
mix auix.gen.stylesheet --baseline --force
mix auix.gen.stylesheet --custom
mix auix.gen.stylesheet --custom --force--baseline flag: opt-in auix-baseline.css scaffold
Tailwind v4 (and similar resets) already normalises html, body, and a.
Hosts with no preflight — plain CSS apps, vanilla Phoenix apps, Web
Component hosts — should pass --baseline to scaffold
assets/css/auix-baseline.css, then @import it before
auix-variables.css. Tailwind hosts must skip this file; double-resetting
can produce subtle border and spacing regressions.
--custom flag: opt-in auix-custom.css scaffold
Most hosts cover their styling needs through a bridge alone. Pass --custom
to also scaffold assets/css/auix-custom.css — a host-owned file that sits
in @layer auix.bridge and contains every --auix-* variable commented out
with its current default. Uncomment the variables you want to override.
The file is treated as host-owned and will not be overwritten on subsequent
runs. Combine --custom with --force to regenerate an existing stub from
the current theme defaults.
Flag matrix
| Invocation | Variables / rules / shim | daisyUI bridge | auix-baseline.css | auix-custom.css |
|---|---|---|---|---|
mix auix.gen.stylesheet | regenerated | copied if absent | not created | not created |
mix auix.gen.stylesheet --force | regenerated | overwritten | not created | not created |
mix auix.gen.stylesheet --baseline | regenerated | copied if absent | created if absent; skipped (with stdout note) if present | not created |
mix auix.gen.stylesheet --baseline --force | regenerated | overwritten | overwritten | not created |
mix auix.gen.stylesheet --custom | regenerated | copied if absent | not created | created if absent; skipped (with stdout note) if present |
mix auix.gen.stylesheet --custom --force | regenerated | overwritten | not created | overwritten |
mix auix.gen.stylesheet --baseline --custom | regenerated | copied if absent | created if absent | created if absent |
mix auix.gen.stylesheet --baseline --custom --force | regenerated | overwritten | overwritten | overwritten |
Import order for hosts using customization
@import "auix-variables.css";
@import "auix-bridge-daisyui.css"; /* or your custom bridge */
@import "auix-custom.css"; /* host customizations (opt-in via --custom) */
@import "auix-rules.css";For the full customization workflow, including the variable reference and recipe
table, see guides/core/styling.md.
Import order for non-Tailwind hosts (no customization)
@import "auix-baseline.css"; /* non-Tailwind hosts only; generate with --baseline */
@import "auix-variables.css";
@import "<your-bridge>.css"; /* optional */
@import "auix-rules.css";Import order for Tailwind hosts (no customization)
Hosts using Tailwind v4 (or any other CSS preflight/reset) should skip
auix-baseline.css and use the two-file path or the legacy shim:
@import "auix-variables.css";
@import "auix-rules.css";
/* or simply: @import "auix-stylesheet.css"; */