| name | nostrstack-dev-workflow |
| description | Local development workflow for nostrstack, including running API/gallery with logs, regtest stack usage, MCP Chrome DevTools verification, QA fallback, and environment/setup troubleshooting. Use when starting dev, debugging, reproducing issues, or validating UI/console/network behavior in the nostrstack repo. |
Nostrstack Dev Workflow
Follow this workflow when working in the nostrstack repo.
Core workflow
- Read
references/dev-workflow.mdfor the required log + UI verification steps. - Keep API + gallery logs visible while reproducing and fixing.
- For UI changes, verify in Chrome DevTools MCP; if MCP is unavailable, run the Playwright QA fallback.
Commands checklist
- Start logs:
pnpm dev:logs(ormake dev) and tail.logs/dev/api.log+.logs/dev/gallery.log. - MCP Chrome bridge:
./scripts/mcp-devtools-server.sh+./scripts/mcp-chrome.sh. - QA fallback:
pnpm qa:regtest-demo.
When to read more
- Troubleshooting MCP:
references/mcp-setup.md. - Local demo/regtest flows:
references/local-demo.md. - Testing matrix and env:
references/testing.md.