create-m5kdev 0.23.0 → 0.25.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-m5kdev",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "license": "GPL-3.0-only",
   "repository": {
     "type": "git",

package/templates/minimal-app/AGENTS.md.tpl

@@ -26,5 +26,9 @@
 - Keep the app shell shape: `NuqsAdapter` + `BrowserRouter` + `Providers`.
 - Compose global providers only in `apps/webapp/src/Providers.tsx`.
 - Use `AppConfigProvider` and `AppTrpcQueryProvider` from `@m5kdev/frontend`; use `@m5kdev/web-ui` for web-only UI.
+- Define app roles in `apps/shared/src/modules/app/roles.constants.ts` and pass `roles: APP_ROLES_CONFIG` through `AppConfigProvider` and `createBackendApp` metadata.
+- Add role display labels in `apps/webapp/translations/app.json` using keys like `organization.role.editor` (resolved as `app:organization.role.editor`).
+- When adding custom roles, also extend module grants (for example `*.grants.ts`) so permissions match the new role keys.
+- For upgrading existing apps, see the docs site guide `apps/docs/docs/guides/custom-app-roles-migration.md`.
 - Use `nuqs` for URL state, React Router for routing, HeroUI for UI primitives, and Tailwind v4 for styling.
 - Prefer shared framework utilities from `@m5kdev/frontend` and `@m5kdev/web-ui` before adding local duplicates.

package/templates/minimal-app/apps/server/src/app.ts.tpl

@@ -8,6 +8,7 @@ import { templates } from "{{PACKAGE_SCOPE}}/email";
 import { emailResources } from "{{PACKAGE_SCOPE}}/email/resources";
 import { APP_NAME } from "{{PACKAGE_SCOPE}}/shared/modules/app/app.constants";
 import { AUTH_LOCALE_CONFIG } from "{{PACKAGE_SCOPE}}/shared/modules/app/locale.constants";
+import { APP_ROLES_CONFIG } from "{{PACKAGE_SCOPE}}/shared/modules/app/roles.constants";
 import { USER_LOCALE_HEADER } from "@m5kdev/commons/modules/auth/auth.constants";
 import cors from "cors";
 import express from "express";
@@ -66,6 +67,7 @@ export const builtBackendApp = createBackendApp(
         api: serverUrl,
       },
       locales: AUTH_LOCALE_CONFIG,
+      roles: APP_ROLES_CONFIG,
     },
     i18n: {
       resources: emailResources,

package/templates/minimal-app/apps/shared/src/modules/app/roles.constants.ts.tpl

@@ -0,0 +1,17 @@
+import { defineAuthRoles } from "@m5kdev/commons/modules/auth/auth.roles";
+
+export const APP_ROLES_CONFIG = defineAuthRoles({
+  user: {
+    roles: ["user", "admin"],
+  },
+  organization: {
+    roles: ["member", "admin", "owner"],
+    managerRoles: ["admin", "owner"],
+    assignableRoles: ["member", "admin", "owner"],
+    defaultRole: "member",
+  },
+  team: {
+    roles: ["owner"],
+    defaultRole: "owner",
+  },
+});

package/templates/minimal-app/apps/webapp/src/Providers.tsx.tpl

@@ -5,6 +5,8 @@ import { DialogProvider } from "@m5kdev/web-ui/components/DialogProvider";
 import { ThemeProvider } from "@m5kdev/web-ui/components/theme-provider";
 import { AppLoader } from "@m5kdev/web-ui/modules/app/components/AppLoader";
 import { APP_NAME } from "{{PACKAGE_SCOPE}}/shared/modules/app/app.constants";
+import { AUTH_LOCALE_CONFIG } from "{{PACKAGE_SCOPE}}/shared/modules/app/locale.constants";
+import { APP_ROLES_CONFIG } from "{{PACKAGE_SCOPE}}/shared/modules/app/roles.constants";
 import { Toaster } from "sonner";
 import { Router } from "./Router";
 
@@ -15,6 +17,8 @@ export function Providers() {
         appName: APP_NAME,
         appUrl: import.meta.env.VITE_APP_URL,
         serverUrl: import.meta.env.VITE_SERVER_URL,
+        locales: AUTH_LOCALE_CONFIG,
+        roles: APP_ROLES_CONFIG,
       }}
     >
       <ThemeProvider defaultTheme="light" storageKey="m5kdev-theme">

package/templates/minimal-app/apps/webapp/src/Router.tsx.tpl

@@ -80,11 +80,11 @@ export function Router() {
           <Route path="posts" element={<PostsRoute />} />
           <Route
             path="organization/members"
-            element={<AuthOrganizationMembersRoute managerRoles={["admin", "owner"]} />}
+            element={<AuthOrganizationMembersRoute />}
           />
           <Route
             path="organization/manage"
-            element={<AuthOrganizationChildOrganizationsRoute managerRoles={["admin", "owner"]} />}
+            element={<AuthOrganizationChildOrganizationsRoute />}
           />
           <Route
             path="organization/preferences"
@@ -92,7 +92,6 @@ export function Router() {
               <AuthOrganizationPreferences
                 schema={preferenceSchema}
                 controls={preferenceControls}
-                managerRoles={["admin", "owner"]}
               />
             }
           />

package/templates/minimal-app/apps/webapp/translations/app.json.tpl

@@ -0,0 +1,7 @@
+{
+  "user.role.user": "User",
+  "user.role.admin": "Admin",
+  "organization.role.member": "Member",
+  "organization.role.admin": "Admin",
+  "organization.role.owner": "Owner"
+}