Imported from jose-codegourmet/fe-multi-web-template (packages/ui/AGENTS.md). Install upstream with npx skills add jose-codegourmet/fe-multi-web-template --skill ui. Copyright stays with the author.

Agent Instructions — packages/ui

Local agent instructions for the shared UI package. Read /AGENTS.md first, then this file.

Scope

packages/ui (@fe-template/ui) is the shared UI primitive library for both apps. It contains shadcn/Base UI style components, a DataTable, a ScrollReveal motion component, form helpers, and the cn() utility. It ships TypeScript/TSX source and has no build step.

• Workspace name: @fe-template/ui
• Filter: pnpm --filter @fe-template/ui
• Package name: @fe-template/ui

Public entry points

Consumers

• apps/web — marketing sections, layout, showcase.
• apps/admin — dashboard tables, dialogs, forms, layout, charts.

Both apps consume @fe-template/ui at runtime. No other workspace package (packages/db, packages/config) depends on it.

Important directories

Validation commands

Restrictions and boundaries

• Preserve the public barrel in src/index.ts when adding or renaming components. Do not remove exports unless the component is being deleted.
• Do not import app-specific code into this package. It must remain generic.
• Do not add app-specific business logic to components. Keep primitives composable.
• Keep peer dependencies minimal: react and react-dom are currently required.
• Adding a new dependency here affects both apps. Prefer adding to a specific app if the dependency is not needed by both.

Common task routing

Documentation maintenance

Update this file and packages/ui/docs/ when:

• A new public export is added.
• A component API changes.
• A new consumer appears.
• The build or validation commands change.