@podosoft/podokit 0.5.0 → 0.5.1

package/README.md

@@ -23,6 +23,18 @@ The `todo` template (`--template todo`) generates a working todo app (SvelteKit
 
 ![Generated todo app](https://raw.githubusercontent.com/podosoft-dev/podokit/main/docs/images/todo-app.png)
 
+## Commands
+
+| Command | What it does |
+|---|---|
+| `podo create <name>` | Scaffold a new project from a template |
+| `podo add <module>` | Add a feature module (auth, admin-dashboard, redis, …) to a project |
+| `podo status` | Show the PodoKit version, modules, file tiers, and local edits |
+| `podo diff` | List the PodoKit-managed files you've edited since generation |
+| `podo doctor` | Check framework versions against the supported ranges |
+| `podo update [--apply]` | Preview (or apply) what a version update would change |
+| `podo eject <path…>` | Take ownership of a managed file so updates skip it |
+
 ## Usage
 
 ```
@@ -61,6 +73,25 @@ npx @podosoft/podokit add auth      # full auth (better-auth): email/password, s
 
 `podo add <module>` overlays files, merges dependencies, appends env vars, and wires the module into the NestJS app. Run `podo add` with no argument to list available modules.
 
+The **`admin-dashboard`** module adds a ready-made admin console on top of `auth` — login/signup pages, user & session management, an audit log, and a Settings page where OAuth providers, SMTP, and server toggles are configured at runtime (stored encrypted in the DB, applied without a restart):
+
+![PodoKit admin dashboard — users](https://raw.githubusercontent.com/podosoft-dev/podokit/main/docs/images/admin-users.png)
+
+## Keep your project up to date
+
+Every generated project records how it was assembled in a committed `.podokit/`
+directory, so it can receive template and module improvements later without
+losing your work:
+
+```bash
+podo status          # version, modules, and which managed files you've edited
+podo update          # preview what a newer PodoKit version would change
+podo update --apply  # apply it: clean updates are written, your edits are 3-way merged
+```
+
+Files you own (routes, your components, shadcn UI) are never touched. See the
+[updating guide](https://github.com/podosoft-dev/podokit/blob/main/docs/updating.md).
+
 ## What you get (`fullstack-nest-svelte`)
 
 ```

package/dist/templates/modules/admin-dashboard/files/tests/ui/organizations.ui.spec.ts

@@ -44,9 +44,12 @@ test("create an org with a non-ascii name, a parent, and a manager @smoke", asyn
   // child row shows the parent org name
   await expect(page.getByRole("row", { name: new RegExp(child) })).toContainText(parent);
 
-  // clean up both
-  for (const n of [child, parent]) {
-    await page.getByRole("row", { name: new RegExp(n) }).getByRole("button", { name: "Delete" }).click();
-    await expect(page.getByText("Organization deleted").first()).toBeVisible();
-  }
+  // Clean up. Delete the child first (its row also shows the parent name, so a
+  // parent-name match isn't unique until the child is gone), and wait for the
+  // child row to disappear before removing the parent.
+  await page.getByRole("row", { name: new RegExp(child) }).getByRole("button", { name: "Delete" }).click();
+  await expect(page.getByText("Organization deleted").first()).toBeVisible();
+  await expect(page.getByRole("cell", { name: child, exact: true })).toHaveCount(0);
+  await page.getByRole("row", { name: new RegExp(parent) }).getByRole("button", { name: "Delete" }).first().click();
+  await expect(page.getByText("Organization deleted").first()).toBeVisible();
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@podosoft/podokit",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "An opinionated but extensible starter toolkit and CLI for full-stack TypeScript apps with NestJS, SvelteKit, TailwindCSS, shadcn-svelte, Docker, and k3s.",
   "license": "Apache-2.0",
   "repository": {