Back to Details

starwind-pro

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Starwind Pro

Starwind Pro

Start Here

入门指南

Use this skill when the user wants production-ready Starwind Pro blocks, Pro setup help, or a free/pro block recommendation for an Astro project.
Starwind Pro builds on Starwind UI. Blocks are native 
.astro
components styled with Tailwind CSS v4, installed into the user's codebase, and customized directly.
当用户需要适用于生产环境的Starwind Pro区块、Pro设置帮助，或是针对Astro项目的免费/Pro区块推荐时，使用此技能。
Starwind Pro 基于 Starwind UI 构建。区块是原生的 
.astro
组件，采用 Tailwind CSS v4 样式，可安装到用户的代码库中并直接进行自定义。

Core Rules

核心规则

  • Starwind Pro is for Astro projects. Confirm the project is Astro before setup or install work.
  • Pro setup requires Starwind UI configuration. If it is missing, initialize with Pro support.
  • Use current metadata before naming a block. Prefer the Starwind MCP 
    search_starwind_pro_blocks
    tool when available.
  • Use the exact install command returned by the MCP, CLI, or block page. Do not invent slugs, dependencies, plans, or private URLs.
  • Distinguish free and premium blocks. Free blocks do not require a paid license; premium blocks require Starwind Pro access.
  • Never expose, hardcode, or ask the user to paste a license key into source files.
  • Starwind Pro 适用于Astro项目。在进行设置或安装操作前，请确认项目为Astro项目。
  • Pro设置需要Starwind UI配置。如果缺少该配置，请初始化并启用Pro支持。
  • 在命名区块前，请使用最新的元数据。如果可用，优先使用Starwind MCP的 
    search_starwind_pro_blocks
    工具。
  • 使用MCP、CLI或区块页面返回的准确安装命令。不要自行创建slug、依赖项、方案或私有URL。
  • 区分免费和付费区块。免费区块无需付费许可证；付费区块需要Starwind Pro访问权限。
  • 切勿暴露、硬编码或要求用户将许可证密钥粘贴到源文件中。

Required Context

必要检查

Before recommending or installing a block, check:
  1. package.json
    , 
    astro.config.*
    , and project layout to confirm this is an Astro app.
  2. components.json
    , 
    src/styles/starwind.css
    , and local components to confirm Starwind UI and Pro setup.
  3. .gitignore
    for 
    .env.local
    if license setup is involved.
  4. The target page/layout and import aliases before wiring a block into the app.
在推荐或安装区块前，请检查：
  1. package.json
    、
    astro.config.*
    和项目结构，确认这是一个Astro应用。
  2. components.json
    、
    src/styles/starwind.css
    和本地组件，确认Starwind UI和Pro已完成设置。
  3. 如果涉及许可证设置，检查 
    .gitignore
    中是否包含 
    .env.local
    。
  4. 在将区块接入应用前，确认目标页面/布局和导入别名。

Common Workflows

常见工作流程

Setup

设置

  • New project or missing Starwind UI: use 
    npx starwind@latest init --pro
    .
  • Existing Starwind project: use 
    npx starwind@latest setup
    .
  • For package-manager-specific commands, use the Starwind MCP result or the CLI 
    --package-manager
    option instead of guessing.
  • pnpm projects may need the 
    .npmrc
    settings from 
    setup.md
    .
  • 新项目或缺少Starwind UI：使用 
    npx starwind@latest init --pro
    。
  • 已有Starwind项目：使用 
    npx starwind@latest setup
    。
  • 针对特定包管理器的命令，请使用Starwind MCP的结果或CLI的 
    --package-manager
    选项，不要自行猜测。
  • pnpm项目可能需要 
    setup.md
    中的 
    .npmrc
    设置。

Find And Install Blocks

查找并安装区块

  1. Search by intent, category, or plan, such as hero, pricing, authentication, FAQ, navigation, footer, feature, testimonial, contact, or theme-switcher.
  2. Use the returned 
    installCommand
    as written, or use 
    starwind_add
    to generate the validated command. Pro commands can include Starwind UI component dependencies such as 
    button
    or 
    aspect-ratio
    .
  3. After installation, read the added files before using them.
  4. Wire the block into the requested route using the project's aliases and layout conventions.
  5. Replace placeholder copy, links, images, and data while preserving Astro syntax and Starwind imports.
  1. 按用途、类别或方案搜索，例如hero（英雄区）、pricing（定价区）、authentication（认证区）、FAQ（常见问题）、navigation（导航）、footer（页脚）、feature（功能区）、testimonial（客户评价）、contact（联系区）或theme-switcher（主题切换器）。
  2. 直接使用返回的 
    installCommand
    ，或使用 
    starwind_add
    生成经过验证的命令。Pro命令可能包含Starwind UI组件依赖，例如 
    button
    或 
    aspect-ratio
    。
  3. 安装完成后，在使用前查看添加的文件。
  4. 使用项目的别名和布局约定，将区块接入指定路由。
  5. 替换占位文案、链接、图片和数据，同时保留Astro语法和Starwind导入语句。

Design And Customization

设计与自定义

  • Pro blocks use the same Starwind UI theme variables and 
    dark:
    class strategy. Prefer theme variables and focused class changes over broad rewrites.
  • Keep container-query, responsive, animation, and dark-mode behavior intact unless the user asks to change it.
  • If adding scroll-entry animation, prefer the documented 
    motion-on-scroll
    approach for Astro pages.
  • Keep edits local to installed blocks or their data/config unless a shared theme change is intended.
  • Pro区块使用与Starwind UI相同的主题变量和 
    dark:
    类策略。优先使用主题变量和针对性的类修改，而非大范围重写。
  • 除非用户要求更改，否则保留容器查询、响应式、动画和暗黑模式的原有行为。
  • 如果添加滚动进入动画，优先使用Astro页面文档中记录的 
    motion-on-scroll
    方法。
  • 除非要进行共享主题更改，否则仅对已安装的区块或其数据/配置进行本地编辑。

Detailed References

详细参考

  • Setup, license, registry, and troubleshooting: 
    setup.md
  • Block search, install commands, and adaptation: 
    blocks.md
Load only the reference needed for the current task.
  • 设置、许可证、注册表和故障排除：
    setup.md
  • 区块搜索、安装命令和适配：
    blocks.md
仅加载当前任务所需的参考内容。