DDEV Add-on

The DDEV add-on installs the Decodie UI as a daemon inside your DDEV web container and routes it to https://decodie.<project>.ddev.site.

Setup

ddev add-on get owenbush/decodie-ddev
ddev restart
ddev decodie

That’s it. The last command opens the UI in your browser.

Q&A configuration

To enable the Q&A feature, add an API key to .ddev/decodie/.env:

ANTHROPIC_API_KEY=sk-ant-api03-...

Any supported provider works — set the corresponding env var instead. You can also override the model:

LLM_MODEL=claude-sonnet-4-6

The add-on checks two .env files in order:

1. .decodie/.env (shared with VS Code extension)
2. .ddev/decodie/.env (DDEV-specific override)

Commands

The add-on provides a ddev decodie host command:

Command	Description
ddev decodie	Open Decodie in your browser
ddev decodie status	Show entry statistics
ddev decodie settings	Open settings page
ddev decodie lessons	Open lessons page
ddev decodie help	Show usage information

How it works

1. The add-on installs @owenbush/decodie-ui via npm inside .ddev/decodie/
2. A daemon process serves the UI on port 8081 inside the web container
3. Traefik routes https://decodie.<project>.ddev.site to that port
4. DDEV handles DNS and TLS certificates automatically

The UI reads your .decodie/ directory from the project root — the same entries generated by the Decodie skills, VS Code extension, or GitHub Action.

Uninstalling

ddev add-on remove decodie
ddev restart