SaaS Kit

A Mix-task CLI that installs Phoenix SaaS boilerplate features (auth, billing, teams, landing pages, …) from livesaaskit.com into your existing Phoenix application.

You pick features from the catalog at livesaaskit.com, get a boilerplate token, and run mix saaskit.feature.install <slug> in your project. The task talks to the API, receives a list of file operations, and applies them locally. Nothing is installed remotely; everything happens in your repo.

Requirements

Elixir ~> 1.16
Phoenix ~> 1.8
A boilerplate token from livesaaskit.com

Installation

Add saas_kit to your mix.exs deps:

def deps do
  [
    {:saas_kit, "~> 2.6", only: :dev, runtime: false}
  ]
end

Then add your token to config/config.exs:

config :saas_kit,
  boilerplate_token: "your_token_here"

Get the token from your boilerplate page at livesaaskit.com.

Quickstart

mix phx.new my_app && cd my_app
# add saas_kit to mix.exs + token to config
mix deps.get
mix saaskit.status               # sanity-check config + API
mix saaskit.setup                # run initial setup; optionally install agent guidance
mix saaskit.feature.list   # see what's available
mix saaskit.feature.install auth # install a feature
mix saaskit.feature.install payments --decision provider=stripe_subscription

For AI agents

All read-only tasks accept --json and emit a stable, versioned schema:

mix saaskit.status --json
mix saaskit.feature.list --json
mix saaskit.feature.show auth --json
mix saaskit.help --json

Every JSON document starts with:

{ "schema_version": 1, "ok": true, ... }

Failures follow the same envelope with stable error codes:

{
  "schema_version": 1,
  "ok": false,
  "error": { "code": "not_configured", "message": "..." }
}

Error codes: not_configured, api_unreachable, feature_not_found.

Failing JSON payloads are written to stdout and the task exits non-zero.

Tasks

Task	Purpose
`mix saaskit.help`	Show the task catalog and getting-started guide (`--json` for structured catalog).
`mix saaskit.status`	Report config, app, installed feature counts, suggested next command (`--json`).
`mix saaskit.setup`	Run initial project setup, create `.saaskit.yml`, and offer guidance files for common coding agents. Use `--agent-skills` or `--no-agent-skills` in scripts.
`mix saaskit.feature.install <slug>`	Install one feature. `--token` to override, `--step <uuid>` to resume, `--decision key=option` to answer choices noninteractively.
`mix saaskit.plan.install <plan_id>`	Install every feature in a saved plan, in order.
`mix saaskit.feature.list`	List all features with installation status (`--filter`, `--json`).
`mix saaskit.feature.show <slug>`	Show full detail for a single feature (`--json`).

Troubleshooting

not_configured — boilerplate_token is missing. Add it to config/config.exs as shown above.

api_unreachable — The task could not reach livesaaskit.com or your token did not resolve. Check your network, verify the token on your boilerplate page, and re-run.

Install failed mid-way — feature installs emit a step id when they fail. Resume with:

mix saaskit.feature.install <slug> --step <uuid>

A feature requires a choice - interactive installs prompt for each declared choice. In scripts or agent workflows, pass it explicitly:

mix saaskit.feature.install payments --decision provider=stripe_subscription

Project State And Agent Guidance

After a successful mix saaskit.setup, SaaS Kit creates .saaskit.yml if it does not already exist:

initial_install: false

Setup also offers to install task guidance for common coding assistants:

Claude Code: .claude/skills/saaskit/SKILL.md
Codex: .codex/skills/saaskit/SKILL.md
Cursor: .cursor/rules/saaskit.mdc
GitHub Copilot: .github/instructions/saaskit.instructions.md

Use mix saaskit.setup --agent-skills to accept this in an automated setup, or mix saaskit.setup --no-agent-skills to suppress the prompt.

Configuration reference

Key	Default	Purpose
`:boilerplate_token`	(required)	Your boilerplate's API token.
`:base_url`	`"https://livesaaskit.com"`	API host. Override for self-hosted / staging.

License

MIT. Maintained by fullstack-phoenix/saas_kit.