frontend
Scaffold frontend CRUD pages - queries hook, route, page, table, and create dialog. Use after data_model scaffold when building UI for an entity.
When & Why to Use This Skill
This Claude skill automates the generation of comprehensive frontend CRUD interfaces for React applications. It streamlines the development lifecycle by scaffolding essential boilerplate including TanStack query hooks, TanStack Router configurations, data tables, and interactive creation dialogs, ensuring architectural consistency and significantly reducing manual coding time.
Use Cases
- Rapidly prototyping administrative dashboards and management interfaces for new database entities.
- Standardizing frontend codebases by enforcing consistent patterns for routing, data fetching, and UI components across a team.
- Accelerating the transition from data model definition to functional user interfaces in full-stack React projects.
- Reducing manual effort and potential for human error when setting up repetitive CRUD views, form validations, and API integrations.
| name | frontend |
|---|---|
| description | Scaffold frontend CRUD pages - queries hook, route, page, table, and create dialog. Use after data_model scaffold when building UI for an entity. |
Frontend Scaffolding
Generates React components for CRUD operations on an entity.
Quick Scaffold
python .claude/skills/frontend/scripts/scaffold.py <EntityName>
# Examples:
python .claude/skills/frontend/scripts/scaffold.py Campaign
python .claude/skills/frontend/scripts/scaffold.py BlogPost --dry-run
Prerequisites: Run data_model scaffold first to create oRPC routes.
Generated Files
| File | Path |
|---|---|
| Queries hook | packages/dash/ui/src/queries/{entity-name}.ts |
| Route | packages/dash/ui/src/routes/_authenticated/workspaces/$workspaceSlug/{entity-name}.tsx |
| Page | packages/dash/ui/src/components/{entity-name}/{EntityName}Page.tsx |
| Table | packages/dash/ui/src/components/{entity-name}/{EntityName}Table.tsx |
| Create dialog | packages/dash/ui/src/components/{entity-name}/{EntityName}CreateDialog.tsx |
Post-Scaffold Steps
- Add route to sidebar (if needed)
- Customize table columns
- Add form fields to create dialog
- Run
pnpm lint
Patterns
Grouped Query Hook
All CRUD operations in one hook:
const { list, create, update, remove } = useCampaign();
// List data
const { data, isLoading } = list;
// Mutations
await create.mutateAsync({ workspaceSlug, name });
await update.mutateAsync({ workspaceSlug, id, name });
await remove.mutateAsync({ workspaceSlug, id });
oRPC Direct Usage
For one-off queries, use oRPC directly:
import { orpc } from "@/lib/orpc-client";
// In component
const { data } = useQuery(
orpc.campaign.list.queryOptions({
input: { workspaceSlug },
})
);
// Direct call (in handlers, loaders)
const result = await orpc.campaign.create.call({
workspaceSlug,
name: "New Campaign",
});
// Query key for invalidation
queryClient.invalidateQueries({
queryKey: orpc.campaign.list.key({ input: { workspaceSlug } }),
});
TanStack Router Pattern
import { createFileRoute } from "@tanstack/react-router";
import * as z from "zod";
const searchSchema = z.object({
status: z.enum(["active", "paused"]).optional(),
page: z.coerce.number().positive().optional(),
});
export const Route = createFileRoute(
"/_authenticated/workspaces/$workspaceSlug/campaign",
)({
validateSearch: searchSchema,
pendingComponent: WorkspaceLoading,
component: CampaignPage,
});
Reference Files
| Component | Example |
|---|---|
| Queries | packages/dash/ui/src/queries/radar.ts |
| Route | packages/dash/ui/src/routes/_authenticated/workspaces/$workspaceSlug/radar.tsx |
| Page | packages/dash/ui/src/components/radar/RadarPage.tsx |
| Table | packages/dash/ui/src/components/radar/RadarSourceTable.tsx |