Skip to content

[expo-ui] State the lowercase docs slug for per-component URLs - #248

Open
RaphaelFakhri wants to merge 1 commit into
expo:mainfrom
RaphaelFakhri:fix/expo-ui-docs-slug
Open

RaphaelFakhri wants to merge 1 commit into
expo:mainfrom
RaphaelFakhri:fix/expo-ui-docs-slug

Conversation

@RaphaelFakhri

Copy link
Copy Markdown

Fixes #57

Why

The SwiftUI, Jetpack Compose, and universal references tell the agent to fetch .../sdk/ui/<layer>/{component-name}/index.md before using a component. The URL template does not say how to form the slug, so agents substitute the component name as written (Button) or in kebab case (bottom-sheet). Both return 404 on docs.expo.dev, and the agent writes code without confirming the API. The pages exist only at the lowercased name without hyphens (button, bottomsheet).

drop-in-replacements.md already states this rule. This change adds the same note, with examples that resolve, to the other three references.

How

  • references/swift-ui.md, references/jetpack-compose.md, references/universal.md: append (slug is the component name lowercased, no hyphens, e.g. ...) to the per-component docs URL, matching the existing wording in drop-in-replacements.md.
  • Bump all four plugin manifests to 1.13.11.

Test plan

  • Checked the documented example slugs against docs.expo.dev: swift-ui/button, swift-ui/bottomsheet, swift-ui/navigationstack, jetpack-compose/button, jetpack-compose/bottomsheet, jetpack-compose/datetimepicker, universal/button, universal/bottomsheet, universal/textinput all return 200. swift-ui/Button, swift-ui/bottom-sheet, jetpack-compose/Button, jetpack-compose/date-time-picker, universal/BottomSheet, and universal/text-input return 404.
  • bun scripts/check-skill-limits.ts passes.
  • bun scripts/check-plugin-version-bump.ts origin/main passes.
  • bun scripts/check-overview-routing.ts passes.
  • bun test scripts/check-plugin-version-bump.test.ts: 20 pass, 0 fail.

@RaphaelFakhri

Copy link
Copy Markdown
Author

Rebased onto current main. The separate Codex, Cursor and Grok manifests no longer exist there, so the PR now bumps plugins/expo/plugin.json and .claude-plugin/plugin.json to 1.14.1 with the version check script, and the version, skill-limit and plugin validation checks pass.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Wrong reference to documentation in swift-ui / jetpack-compose skills

1 participant