metacore-starter

Vite + React starter that consumes the metacore SDK modularly. Use this as the source of truth when bootstrapping a new app in the metacore ecosystem — clone, rename, build.

Stack

• Build: Vite + @asteby/metacore-starter-config (defineMetacoreConfig preset)
• Framework: React 19 + TypeScript
• Routing: TanStack Router
• Data: TanStack Query
• Styling: Tailwind v4 + @asteby/metacore-theme
• UI primitives: @asteby/metacore-ui (shadcn-derived, RTL-aware)
• Auth pages + store: @asteby/metacore-auth
• i18n: @asteby/metacore-i18n (i18next under the hood)

What's included

• Auth flow: /sign-in, /sign-up, /forgot-password, /otp (wired to @asteby/metacore-auth/pages — wire onSubmit to your backend).
• Authenticated shell: AppShell consumes AuthenticatedLayout + AppSidebar + Header + ProfileDropdown from @asteby/metacore-ui/layout.
• Minimal dashboard placeholder.
• Settings: profile, appearance (theme + font), notifications.
• Error pages: 401, 403, 404, 500, 503 — all from @asteby/metacore-ui/error-pages.

Run locally

pnpm install
pnpm dev

Other scripts:

• pnpm typecheck — TypeScript check
• pnpm lint — ESLint
• pnpm build — production build (runs tsc -b && vite build)
• pnpm preview — serve the build

Customize

1. Update the brand name & logo in src/components/layout/app-shell.tsx, src/assets/logo.tsx and the auth route components.
2. Replace the onSubmit stubs in src/routes/(auth)/*.tsx with real backend calls (see @asteby/metacore-auth/api-client).
3. Add navigation entries in src/components/layout/app-shell.tsx (navGroups).
4. Drop your features in src/features/ and routes in src/routes/_authenticated/.
5. Translation strings live in src/i18n/locales/{en,es}.json. The base SDK strings are merged from @asteby/metacore-i18n/locales.

License

MIT