blutui Blutui Project Guidelines
Load the rule files that match your task. Always load ALL that apply — multiple rules often overlap.
Rule Index
| Task | Load |
|---|---|
| Creating/editing any template, layout, or component | rules/foundation-templates-and-layouts.md |
| Writing Canvas template syntax (tags, filters, functions) | rules/templating-canvas.md |
| Including/embedding other templates | rules/templating-including-templates.md |
| Working with Collections (querying, displaying data) | rules/collections.md |
| Building a blog listing or post page | rules/blog.md |
| Building or processing forms | rules/forms.md |
| Building site navigation (header, footer, dropdowns) | rules/menus.md |
| Setting up routing or URL patterns | rules/route-patterns.md |
| Configuring Courier | rules/courier.md, rules/foundation-courier-configuration.md |
| Project file structure / starting a new project | rules/foundation-file-structure.md |
| Version control / switching cassettes | rules/cassettes.md |
| Calling the Blutui MCP or writing MCP integrations | rules/mcp.md |
| Using Canopy Blocks (in-page editor) | rules/canopy.md + the blutui-canopy-blocks skill |
Rule files live at: rules/<rule-name>.md
Core Rules (Always Apply)
- Templates are the HTML shell; layouts are page types editors choose. Templates (
views/templates/) define the outer structure that wraps every page — developers own them, editors never touch them. Layouts (views/layouts/) extend templates and represent individual page designs that editors pick when creating pages in the dashboard. Seerules/foundation-templates-and-layouts.md. - Use Canvas for all templating logic. See
rules/templating-canvas.md. - Store structured content in Collections, not hardcoded in templates. See
rules/collections.md. - Never build raw HTML forms — use Blutui's form tags. See
rules/forms.md. - Don't invent new top-level directories. See
rules/foundation-file-structure.md. - Search documentation first. Use
search_blutui_documentationvia Blutui MCP before making code changes. Seerules/mcp.md.
Full Reference
For all rules in one document: AGENTS.md
Use AGENTS.md when you need a comprehensive reference or are unsure which rules apply.