new-page

Creates a new frontend page with routing, i18n, and navigation.

Infers route, route group, components needed, and data requirements from context. Defaults to (app) (authenticated). Asks only if genuinely ambiguous.

Templates

Use these as starting points - fill in the specifics from context:

• Page and component templates

Conventions

• Button layout: All action/submit buttons use w-full sm:w-auto with wrapper flex flex-col gap-2 sm:flex-row sm:justify-end. Default size only (no size="sm" or size="lg").

Steps

Components (if needed):

1. Create feature folder: src/frontend/src/lib/components/{feature}/
2. Create components with interface Props + $props()
3. Create barrel index.ts exporting all components

Page:

1. Create route directory: src/frontend/src/routes/(app)/{feature}/
   • Or (public)/{feature}/ for unauthenticated pages
2. Create +page.svelte with <svelte:head> using i18n title
3. If server data needed: create +page.server.ts using createApiClient(fetch, url.origin)
4. If admin page: add entry to adminRoutes in $lib/config/routes.ts with path and permission
5. If permission-guarded: add check in +page.server.ts:

   if (!hasPermission(user, adminRoutes.feature.permission)) throw redirect(303, routes.dashboard);
   

Integration:

1. Add i18n keys to the correct feature file in all locale directories
2. Add navigation entry in AppSidebar.svelte (using adminRoutes.feature.path and .permission for admin pages)
3. Add matching entry in CommandPalette.svelte (using adminRoutes.feature.path and .permission for admin pages)
4. If public page: add route to publicRoutes in src/frontend/src/routes/sitemap.xml/+server.ts

Verify and commit:

1. cd src/frontend && pnpm run format && pnpm run lint && pnpm run check - fix errors, loop until green
2. Commit: feat({feature}): add {feature} page

Paraglide module errors (~32) are expected at check time - ignore those. Fix everything else.