blutui/context

blutui-project-guidelines

Blutui project guidelines from the Blutui Engineering team.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/blutui/context --skill blutui-project-guidelines

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Blutui Project Guidelines

Load the rule files that match your task. Always load ALL that apply — multiple rules often overlap.

Rule Index

TaskLoad
Creating/editing any template, layout, or componentrules/foundation-templates-and-layouts.md
Writing Canvas template syntax (tags, filters, functions)rules/templating-canvas.md
Including/embedding other templatesrules/templating-including-templates.md
Working with Collections (querying, displaying data)rules/collections.md
Building a blog listing or post pagerules/blog.md
Building or processing formsrules/forms.md
Building site navigation (header, footer, dropdowns)rules/menus.md
Setting up routing or URL patternsrules/route-patterns.md
Configuring Courierrules/courier.md, rules/foundation-courier-configuration.md
Project file structure / starting a new projectrules/foundation-file-structure.md
Version control / switching cassettesrules/cassettes.md
Calling the Blutui MCP or writing MCP integrationsrules/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)

  1. 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. See rules/foundation-templates-and-layouts.md.
  2. Use Canvas for all templating logic. See rules/templating-canvas.md.
  3. Store structured content in Collections, not hardcoded in templates. See rules/collections.md.
  4. Never build raw HTML forms — use Blutui's form tags. See rules/forms.md.
  5. Don't invent new top-level directories. See rules/foundation-file-structure.md.
  6. Search documentation first. Use search_blutui_documentation via Blutui MCP before making code changes. See rules/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.