使用方法
- 复制安装命令，在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物，并对照来源检查输出。
npx skills add https://github.com/stayhydated/shared --skill use-stayhydated-github-pages开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况，不等于独立质量或安全测试。
按源仓库内容呈现，保留标题、案例、代码、表格、链接以及原文引用的演示图片。
Use stayhydated GitHub Pages
Maintain the consumer's site against its pinned shared API. For a review, report findings and use read-only checks; apply changes when the user requests adoption, updates, or fixes.
Establish the source of truth
- Use the workspace user guide for shared
package roles and the end-to-end consumer workflow. Keep its guidance aligned when changing public adoption behavior.
- Read the consumer's repository guidance, manifests,
justfile, web and xtask
sources, and relevant workflows.
- Read shared source at the consumer's full pinned SHA.
- Identify the project slug, canonical URL, Dioxus base path, routes, generated
outputs, optional browser demos, and default branch.
Choose the application shape
| Consumer need | Shared application |
|---|---|
| One portal route | StayhydatedSinglePageProjectApp with ProjectSite |
| Portal with one embedded static demo | StayhydatedEmbeddedDemoProjectApp and its manifest preset |
| Consumer-defined routes | StayhydatedProjectApp<R> with a consumer-owned Routable enum |
For a new adoption or full-site review, read references/adoption-patterns.md. For a narrow change, read its matching section for dependency pins, application setup, assets, build tasks, demos, preview, or deployment.
Apply the ownership contract
Shared owns generic components, shells, styles, routing helpers, static assembly, and reusable workflows. The consumer owns identity, URLs, destinations, routes, project-specific CSS, demo inputs, and build sequencing.
- Pin
stayhydated-dioxus,stayhydated-site, andstayhydated-xtaskto one
full shared SHA in workspace dependencies. Keep any directly used stayhydated-dioxus-core dependency on that revision too.
- Define consumer-owned
ProjectandProjectSitevalues. Configure a Skills
command or demo path only when its destination exists.
- Keep the web package featureless, enable Dioxus Web directly, and launch with
stayhydated_site::launch(web::App).
- Keep application routes root-relative. Dioxus configuration and shared
routing helpers apply the GitHub Pages project prefix.
- Export one
SiteRouteManifestfor fallback generation and the sitemap.
Build every static output it declares; the project presets include book and LLM destinations.
- Use shared components and bundled styles directly. Put only project-specific
CSS in the consumer, and configure its stylesheet explicitly.
- Assemble the standard layout with
WebBuildConfig::github_pages, adding
explicit assets and demos only when the consumer owns them.
- Commit an up-to-date
Cargo.lockbefore building; shared Dioxus commands
use --locked.
- Keep
web-build,web, andweb-previewdistinct. Build prerequisites before
final assembly, and regenerate output through its owning task.
- Use the reusable Pages workflow for the standard
integration. Install Trunk or nightly only for demos that require them.
Validate the consumer
Select checks from the reference's validation checklist that fit the requested work. Run the consumer audit with --expected-shared-revision. Add --dist and --site-url to inspect an assembled artifact, and --project-style-input for a tracked consumer stylesheet.
The audit checks the standard web/ and xtask/ layout, shared pins, reusable workflows, and declared sitemap destinations. It cannot infer omitted static paths or prove browser behavior. Keep consumer manifest tests for promised outputs and inspect direct navigation under the configured base path when routing or assembly changes.
Report checks that ran, failures, and remaining gaps. For changes to shared itself, start with the affected crates and dummy integration before validating consumers.
