mix skua.setup (Skua v0.11.1)

Copy Markdown View Source

A guided, one-command setup that wires up a Skua app end to end. Run it once inside a fresh Phoenix app:

mix skua.setup

It walks you through:

  • Theme — pick one of the 100 themes, or none (arrow keys on a real terminal; a numbered prompt under CI/pipes).
  • Authentication — none · magic_link · otp · password_otp.
  • Features — a checklist (defaults all on): starter pages, SEO files (robots.txt + llms.txt), strip daisyUI.

Then it runs the generators in the one correct order — skua.install → skua.gen.auth (+ deps.get for Hammer) → skua.gen.pages → skua.gen.seo — so the ordering traps can't bite.

Non-interactive

Every choice maps to a flag, so the same task scripts cleanly:

mix skua.setup --theme rose-pine --auth otp --yes
mix skua.setup --no-pages --no-seo --auth none --yes

Flags: --theme <name> · --auth <flow> · --pages / --no-pages · --seo / --no-seo · --strip-daisy / --no-strip-daisy · --yes (skip the wizard + confirmation, using flags + defaults). With --yes and no --auth, auth defaults to none; the interactive wizard instead pre-selects otp. --theme is validated against mix skua.themes before anything runs.

For AI agents / CI

Runs head-less and never blocks on input. The canonical agent command is fully explicit:

mix skua.setup --theme rose-pine --auth otp --pages --seo --yes

With no TTY (a pipe, CI, or an agent subprocess) the wizard is skipped automatically and the task runs from flags + defaults — so even mix skua.setup --auth otp works unattended. The resolved plan is printed before anything runs.