tribes-plugin-template/docs/development.md

Development

Local Setup

This template expects a sibling Tribes checkout at ../tribes.

mix deps.get
devenv shell -- plugin test

To load the plugin in the host during development:

cd ../tribes
ln -s ../tribes-plugin-template plugins/my_plugin
iex --sname dev -S mix phx.server

Set TRIBES_HOST_ROOT=/path/to/tribes if your host checkout is not a sibling.

Command Wrapper

Use scripts/plugin for host-aware workflows:

scripts/plugin validate
scripts/plugin test
scripts/plugin precommit
scripts/plugin smoke

Inside the template devenv shell, the plugin command is available and forwards through the same wrapper.

Prefer plugin test over raw mix test for host-backed plugin suites. The wrapper runs Mix with the host database/services and points the host plugin manager at the host manifest plus built-in providers such as tribes_ui. Use mix raw_test / mix raw_precommit only for deliberate low-level debugging.

Assets

Browser code lives in assets/ts and is compiled to priv/static:

devenv shell -- npm run build --prefix assets

Use the wrapper form for installs too:

devenv shell -- npm install --prefix assets