@swarm.ing/pieui 2.0.10 → 2.0.13

package/README.md

@@ -91,6 +91,18 @@ Type exports:
 
 ## CLI Template Scaffolding
 
+Create a fresh Next.js app and initialize PieUI in it:
+
+```sh
+bunx pieui create my-app-name
+```
+
+This command:
+
+- runs `bun create next-app@latest my-app-name --yes`
+- initializes `piecomponents/registry.ts` and PieUI config in the new app
+- prepares the app for `bunx pieui card add ...`
+
 Create a blank Next.js web app template with PieUI CLI:
 
 ```sh
@@ -115,3 +127,39 @@ Planned create flow target:
 ```sh
 bun create pieui@latest my-pie-app
 ```
+
+Create a page scaffold inside an existing Next app:
+
+```sh
+bunx pieui page add chat
+```
+
+This command writes `app/chat/page.tsx` with the standard Suspense-wrapped Pie page shell:
+
+```tsx
+"use client";
+
+import PiePage from "@/app/_shared/simple";
+import { Suspense } from "react";
+import LoadingScreen from "@/components/LoadingScreen";
+
+export default function ChatPage() {
+  return (
+    <Suspense fallback={<LoadingScreen />}>
+      <PiePage />
+    </Suspense>
+  );
+}
+```
+
+Create a component scaffold inside `piecomponents/`:
+
+```sh
+bunx pieui card add simple StatusCard
+```
+
+Add optional realtime and AJAX fields to the generated `types/index.ts`:
+
+```sh
+bunx pieui card add simple LiveCard --io --ajax
+```