Building with Fancy
Building with Fancy
The stack, the loop, and how the tutorials fit together.
Most component-library docs stop at "here's a button." This section is the other half: how you assemble the primitives into a real application — the shell, the navigation, the motion, the responsive behavior — and how you do all of it so that humans and agents inhabit the same surface. That last part is what makes building with Fancy different, and it runs through every page here.
If you've read Human+ UX, this is where the philosophy becomes practice.
The stack we build on
Fancy UI doesn't prescribe a backend, but the showcase you're reading — and these tutorials — assume the canonical Fancy Core stack:
- Laravel for the server, routing, auth, and data.
- Inertia.js (
@particle-academy/fancy-inertia) as the React adapter — pages are server-routed, rendered client-side, no API layer to hand-write. - React 19 + Tailwind v4 (
@particle-academy/react-fancy) for the components and design tokens. @particle-academy/fancy-queryfor server-state (TanStack Query + Inertia hydration + Echo invalidation) when you need live data.
You can use react-fancy in any React app. But the integration tutorials below lean on Inertia, because the seams between server-routed pages and a component kit — layouts, transitions, forms, SSR — are exactly where most teams lose time, and where fancy-inertia earns its place.
The inner loop
The packages are independent npm/Packagist releases, so the development loop is the same one any external consumer runs:
# iterate on a single package in isolation
cd react-fancy && npm run dev
# pull a released change into your app
npm update @particle-academy/react-fancy
# or, for the copy-source path:
npx fancy-cli add card
There are no source aliases — what you build locally is byte-for-byte what ships. See Installation for both consumption models.
What's in this section
| Tutorial | What you'll build |
|---|---|
| Layouts & app shell | A persistent shell — navbar, sidebar, footer — that survives navigation, plus multi-screen apps with fancy-screens. |
| Page transitions | Animated navigation with fancy-inertia's enter/exit crossfade, a live transition picker, and reduced-motion support. |
| Mobile & responsive | Tailwind v4 breakpoints, a collapsing mobile nav, touch targets, and SSR-safe rendering of client-only components. |
| Designing for Human+ | The design discipline: presence, trust-but-verify, and affordances for surfaces two kinds of operators share. |
| Developing for Human+ | The engineering discipline: controlled state, stable handles, bridges, and activity events — the component contract, in code. |
A note on order
Read Layouts first — everything else assumes you have a shell. Page transitions and Mobile are independent after that. The two Human+ pages are the capstone: not optional polish, and one of the reasons the suite exists. Every tutorial here ends by pointing back at them, because a layout, a transition, or a responsive breakpoint that an agent can't perceive or operate is only half-built.
