npm create @pylonsync/pylon@latest has three things for its user interface:
components/ui/: primitives such asButton,DialogandSelect. Their behavior comes from ui-sdk (@ui-sdk/reactand@ui-sdk/core). Their styles are Tailwind classes that read the design tokens./internal/design: a page that shows each design token inapp/globals.css./internal/components: a page that shows each component incomponents/ui/with its variants and states.
app/internal/layout.tsx, a sidebar with a link to each section.
Rules for components
These rules are in theAGENTS.md of each template, so a coding agent follows them.
- Look in
components/and on/internal/componentsbefore you write markup. Use the component that exists. If it almost fits, add a variant or a prop to it. - A page composes components. When the same markup appears a second time, move it into a component.
components/ui/holds primitives with no app data.components/holds the components of the product, built from the primitives.- Build a component from small parts that nest and accept
childrenandclassName. A visual variation is acvavariant. - Use token classes such as
bg-primaryandtext-muted-foreground. To add a token, add it toapp/globals.cssand toapp/internal/design/page.tsx. - When you add or change a component, update its entry in
app/internal/components/page.tsxand inapp/internal/sections.tsin the same change.
Build a primitive on ui-sdk
ui-sdk parts handle focus, keyboard navigation and ARIA attributes. They have no styles. Import each component from its own entry and style its parts with Tailwind:data-slot attribute and state attributes such as data-open, data-disabled and data-selected. Popup content has data-starting-style and data-ending-style for transitions. The packages ship their documentation: read node_modules/@ui-sdk/react/docs/llms.txt, then the page of the component in node_modules/@ui-sdk/react/docs/components/.
To render a part as a different element, pass the element to render:
app/globals.css starts with @layer ui-sdk;. ui-sdk puts a small amount of its own CSS in that layer, and the line makes every style in your stylesheet win over it.
Who can open the internal pages
The product does not link to/internal/*. app/robots.ts disallows the path and the pages set robots: "noindex, nofollow". Anyone who has the URL can open them. To restrict them, read auth in app/internal/layout.tsx and call response.notFound():
ui-sdk is in beta
The templates pin@ui-sdk/react and @ui-sdk/core to one exact version, because a beta release can change an API. Update both packages together, then check /internal/components.