Menu
Welcome to your app
Scaffolded from Ascendra UI
View the source library

Welcome

This page, its sidebar, and this whole /starter route are built entirely from real Ascendra UI components — PageLayout, Card, SideBar, same as everything else in ascendra-ui/. It's a working example, not a mockup — read its source at app/starter/page.tsx to see the patterns in context.

Delete this route whenever you're ready — it's a demo, not a dependency.

Project structure

Only ascendra-ui/ is ever touched by tooling again.

ascendra-ui/ managed

The component library. Replaced wholesale by ascendra.js update — never edit it directly.

app/ yours

Your routes. app/layout.tsx and app/globals.css already wire up theming and providers.

components/, hooks/, lib/ yours

Empty on purpose — your custom components, hooks, and config live here.

providers/, utils/ yours

Your React context providers and pure utility functions.

Check the library first

Before building any UI, check whether the library already has what you need — this is what your AI assistant checks too:

  • ascendra-ui/components/ — browse by category, or check ascendra-ui/index.ts for the full export list. Props are plain TypeScript types on each component — read the source directly.
  • CLAUDE.md — project conventions for Claude Code, already tailored to this stack.

Staying updated

There's no version to track — updating just replaces the library folder with whatever is current on the public repo's default branch. Run this right here, any time:

npm run ascendra-ui:update

This replaces ascendra-ui/ and nothing else. If the update adds a new dependency, install it yourself — check the library's package.json against your own.