@enbox/create-dapp 0.0.4 → 0.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enbox/create-dapp",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Create a minimal Enbox React application",
   "type": "module",
   "license": "Apache-2.0",

package/template/README.md

@@ -30,6 +30,11 @@ toolchain. Production builds precache the app shell for
 later offline visits; `npm run preview` serves that built app locally. Deploy
 the generated `dist` directory on an HTTPS origin with service worker support.
 
+This starter explicitly activates worker updates immediately in `src/sw.ts`.
+Apps with an update prompt, such as Notesd, approve activation after pending
+edits are persisted. `prepareBrowser()` waits for the current worker; it does
+not choose an application's update policy.
+
 You can also use `bun install` and `bun run dev`. No lockfile is generated
 until your first install. Commit the resulting `package-lock.json` or `bun.lock`;
 then use `npm ci` or `bun install --frozen-lockfile` in CI. Direct dependencies
@@ -53,7 +58,7 @@ src/
     protocol.ts         # typed encrypted records and validation
     store.ts            # shared observations, commands, and domain defaults
     components/         # task board and its styles
-  shared/components/
+  components/           # reusable UI shared by features
     ProfileCard.tsx
   main.tsx
   sw.ts
@@ -61,10 +66,14 @@ src/
 
 `createApplication` derives the protocol manifest from registered stores and
 constructs the browser connection with the configured wallet identity.
-`getApplication()` keeps one headless runtime for the browser lifetime.
+`getApplication()` keeps one headless runtime for the page lifetime.
 `main.tsx` waits for worker control before passing that runtime to
 `EnboxProvider application={...}`. The provider initializes the borrowed runtime;
-the application owns its lifetime. Development module replacement disposes it.
+the application owns its page lifetime. Component Fast Refresh is useful for UI
+edits, but replacing a connected runtime or its store/protocol definitions is
+not a supported hot-reload operation. Disconnect before changing those files,
+then reload the page. Apps with document writers, such as Notesd, drain edits
+as part of disconnecting.
 
 The profile card reads published profile information through `useProfile`.
 Names, images, settlement state, and image URL lifetimes belong to the SDK.

package/template/package.json

@@ -10,8 +10,8 @@
     "preview": "vite preview"
   },
   "dependencies": {
-    "@enbox/browser": "0.3.84",
-    "@enbox/react": "0.0.9",
+    "@enbox/browser": "0.3.85",
+    "@enbox/react": "0.0.10",
     "react": "19.3.0",
     "react-dom": "19.3.0"
   },

package/template/src/app/App.tsx

@@ -3,7 +3,7 @@ import { useEffect } from 'react';
 
 import app from '../app.json' with { type: 'json' };
 import { TaskBoard } from '../features/tasks/components/TaskBoard.js';
-import { ProfileCard } from '../shared/components/ProfileCard.js';
+import { ProfileCard } from '../components/ProfileCard.js';
 
 export function App() {
   const connection = useEnboxConnection();

package/template/src/app/application.ts

@@ -10,9 +10,7 @@ export const applicationOptions = {
 
 let application: ReturnType<typeof createApplication> | undefined;
 
-/** One browser-lifetime owner shared by React and application controllers. */
+/** One application owner for this page, shared by React and application controllers. */
 export function getApplication() {
   return application ??= createApplication(applicationOptions);
 }
-
-if (import.meta.hot) import.meta.hot.dispose(() => { void application?.dispose(); });

package/template/src/sw.ts

@@ -36,5 +36,7 @@ if (import.meta.env.PROD) {
   });
 }
 
-// The current browser SDK performs automatic worker takeover.
+// This starter activates updates immediately. Apps with an update prompt should
+// call skipWaiting only after the user accepts and pending edits are persisted.
+self.addEventListener('install', (event) => { event.waitUntil(self.skipWaiting()); });
 activatePolyfills({ onCacheCheck: () => ({ ttl: 30_000 }) });