@puredesktop/create-app 2.1.5 → 2.1.7

package/template/docs/ui-and-components.md

@@ -1,59 +1,60 @@
-# UI And Components
-
-The generated app starts intentionally small. Build the real workflow in
-`src/components/AppShell.tsx` and move domain logic into `src/lib/` as it grows.
-
-## AppFrame
-
-Every render path in `src/App.tsx` uses `AppFrame`. This gives the iframe the
-PureDesktop reset, theme CSS variables, and shell-compatible surface styling.
-
-## Component Shape
-
-Start with controlled, simple components:
-
-```text
-src/
-  components/
-    AppShell.tsx
-    ItemList.tsx
-    ItemDetail.tsx
-  lib/
-    items.ts
-    items.test.ts
-```
-
-Keep app state close to the workflow until a shared hook or reducer removes real
-duplication.
-
-## Platform Components
-
-Import shared UI from `@puredesktop/puredesktop-ui-bridge/components/...` before
-creating custom primitives.
+# UI And Components
+
+The generated app starts intentionally small. Build the real workflow in
+`src/components/AppShell.tsx` and move domain logic into `src/lib/` as it grows.
+
+## AppFrame
+
+Every render path in `src/App.tsx` uses `AppFrame`. This gives the iframe the
+PureDesktop reset, theme CSS variables, and shell-compatible surface styling.
+
+## Component Shape
+
+Start with controlled, simple components:
+
+```text
+src/
+  components/
+    AppShell.tsx
+    ItemList.tsx
+    ItemDetail.tsx
+  lib/
+    items.ts
+    items.test.ts
+```
+
+Keep app state close to the workflow until a shared hook or reducer removes real
+duplication.
+
+## Platform Components
+
+Import shared UI by exact exported package paths before creating custom
+primitives. Do not invent component folders.
 
 Useful starting points:
 
-- `AppFrame`
-- `EmptyState`
-- `Heading`
-- `Text`
-
-## Styling
-
-Use styled-components and platform CSS variables:
-
-```ts
-const Root = styled.div`
-  display: flex;
-  flex-direction: column;
-  gap: var(--platform-spacing-md);
-  color: var(--platform-colors-text);
-  background: var(--platform-colors-bg);
-`
-```
-
-Use app-local CSS variables only for app-specific meaning, for example
-`--{{APP_SLUG}}-accent`.
-
-See [Theme CSS variables](./theme-vars.md) for the generated list of available
-platform variables by domain.
+- `AppFrame` from `@puredesktop/puredesktop-ui-bridge/components/common/containers/AppFrame`
+- `EmptyState` from `@puredesktop/puredesktop-ui-bridge/components/common/feedback/EmptyState`
+- `Heading` from `@puredesktop/puredesktop-ui-bridge/components/common/typography/Heading`
+- `Text` from `@puredesktop/puredesktop-ui-bridge/components/common/typography/Text`
+- `Button` from `@puredesktop/puredesktop-ui-bridge/components/common/buttons/Button`
+
+## Styling
+
+Use styled-components and platform CSS variables:
+
+```ts
+const Root = styled.div`
+  display: flex;
+  flex-direction: column;
+  gap: var(--platform-spacing-md);
+  color: var(--platform-colors-text);
+  background: var(--platform-colors-bg);
+`
+```
+
+Use app-local CSS variables only for app-specific meaning, for example
+`--{{APP_SLUG}}-accent`.
+
+See [Theme CSS variables](./theme-vars.md) for the generated list of available
+platform variables by domain.

package/template/package.json

@@ -3,16 +3,16 @@
   "private": true,
   "version": "0.1.0",
   "type": "module",
-  "scripts": {
-    "dev": "vite",
-    "build": "vite build",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "puredesktop:check": "node scripts/validate-puredesktop-app.mjs"
-  },
-  "dependencies": {
-    "@puredesktop/puredesktop-ui-bridge": "2.1.4",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "puredesktop:check": "node scripts/validate-puredesktop-app.mjs"
+  },
+  "dependencies": {
+    "@puredesktop/puredesktop-ui-bridge": "2.1.7",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
     "styled-components": "^6.1.18"
   },
   "devDependencies": {

package/template/plugin.json

@@ -1,20 +1,20 @@
-{
-  "schemaVersion": 1,
-  "id": "{{PLUGIN_ID}}",
-  "name": "{{APP_TITLE}}",
-  "permissions": ["network", "settings", "agents"],
-  "entrypoint": {
-    "kind": "dev-url",
-    "url": "http://localhost:{{APP_PORT}}"
-  },
-  "app": {
-    "id": "plugin.{{APP_SLUG}}",
-    "slug": "{{APP_SLUG}}",
-    "name": "{{APP_TITLE}}",
-    "navigationLabel": "{{APP_TITLE}}",
-    "productName": "pure.{{APP_SLUG}}",
-    "kind": "{{APP_SLUG}}",
-    "description": "{{APP_TITLE}} - built with PureDesktop.",
-    "usePureDesktopAiPanel": true
-  }
-}
+{
+  "schemaVersion": 1,
+  "id": "{{PLUGIN_ID}}",
+  "name": "{{APP_TITLE}}",
+  "permissions": ["network", "settings", "agents"],
+  "entrypoint": {
+    "kind": "dev-url",
+    "url": "http://localhost:{{APP_PORT}}"
+  },
+  "app": {
+    "id": "plugin.{{APP_SLUG}}",
+    "slug": "{{APP_SLUG}}",
+    "name": "{{APP_TITLE}}",
+    "navigationLabel": "{{APP_TITLE}}",
+    "productName": "pure.{{APP_SLUG}}",
+    "kind": "{{APP_SLUG}}",
+    "description": "{{APP_TITLE}} - built with PureDesktop.",
+    "usePureDesktopAiPanel": true
+  }
+}

package/template/src/App.tsx

@@ -1,5 +1,5 @@
-import { AppFrame } from '@puredesktop/puredesktop-ui-bridge/components/common/containers/AppFrame'
-import { EmptyState } from '@puredesktop/puredesktop-ui-bridge/components/common/feedback/EmptyState'
+import { AppFrame } from '@puredesktop/puredesktop-ui-bridge/components/common/containers/AppFrame'
+import { EmptyState } from '@puredesktop/puredesktop-ui-bridge/components/common/feedback/EmptyState'
 import { usePlatformBridge } from '@puredesktop/puredesktop-ui-bridge/bridge/react/usePlatformBridge'
 import { AppShell } from './components/AppShell'
 import { isStandaloneDevMode } from './bridge/platformBridge'
@@ -33,8 +33,8 @@ export function App(): React.ReactElement {
             bootError
               ? bootError.message
               : booting
-                ? 'Loading...'
-                : 'Waiting for PureDesktop shell bridge...'
+                ? 'Loading...'
+                : 'Waiting for PureDesktop shell bridge...'
           }
         />
       </AppFrame>

package/template/src/bridge/platformBridge.ts

@@ -1,122 +1,122 @@
-import { bridge } from '@puredesktop/puredesktop-ui-bridge/bridge/client'
-import {
-  getPlatformAppSettings,
-  updatePlatformAppSettings,
-} from '@puredesktop/puredesktop-ui-bridge/bridge/appSettings'
-import {
-  getPlatformPreferences,
-  patchPlatformPreferences,
-} from '@puredesktop/puredesktop-ui-bridge/bridge/preferences'
-import { networkFetch } from '@puredesktop/puredesktop-ui-bridge/bridge/network'
-import {
-  createPlatformFolder,
-  deletePlatformFile,
-  listPlatformFiles,
-  readPlatformFileBinary,
-  readPlatformFileBinaryDataUrl,
-  readPlatformFilePreview,
-  readPlatformFilePreviewUrl,
-  readPlatformTextFile,
-  renamePlatformFile,
-  writePlatformFileBinary,
-  writePlatformTextFile,
-} from '@puredesktop/puredesktop-ui-bridge/bridge/fs'
-import {
-  openPlatformFileDialog,
-  openPlatformFolderDialog,
-  openPlatformImageDialog,
-  savePlatformFolderDialog,
-} from '@puredesktop/puredesktop-ui-bridge/bridge/dialog'
-import {
-  readPlatformStorageJson,
-  writePlatformStorageJson,
-} from '@puredesktop/puredesktop-ui-bridge/bridge/storage'
-import { APP_SLUG } from '../constants'
-import type { AppSettings } from '../types'
-import type {
-  PlatformNetworkFetchRequest,
-  PlatformNetworkFetchResponse,
-} from '@puredesktop/puredesktop-ui-bridge/bridge/network'
-import type {
-  PlatformFileCreateFolderResult,
-  PlatformFileDeleteResult,
-  PlatformFileEntry,
-  PlatformFileListResult,
-  PlatformFilePreviewUrlResult,
-  PlatformFileReadBinaryResult,
-  PlatformFileReadPreviewResult,
-  PlatformFileRenameResult,
-  PlatformFileWriteResult,
-} from '@puredesktop/puredesktop-ui-bridge/bridge/fs'
-import type {
-  PlatformStorageJsonReadResult,
-  PlatformStorageJsonRequest,
-  PlatformStorageJsonWriteRequest,
-  PlatformStorageJsonWriteResult,
-} from '@puredesktop/puredesktop-ui-bridge/bridge/storage'
-
-export {
-  getPlatformAppSettings,
-  updatePlatformAppSettings,
-  getPlatformPreferences,
-  patchPlatformPreferences,
-  networkFetch,
-  createPlatformFolder,
-  deletePlatformFile,
-  listPlatformFiles,
-  readPlatformFileBinary,
-  readPlatformFileBinaryDataUrl,
-  readPlatformFilePreview,
-  readPlatformFilePreviewUrl,
-  readPlatformTextFile,
-  renamePlatformFile,
-  writePlatformFileBinary,
-  writePlatformTextFile,
-  openPlatformFileDialog,
-  openPlatformFolderDialog,
-  openPlatformImageDialog,
-  savePlatformFolderDialog,
-  readPlatformStorageJson,
-  writePlatformStorageJson,
-  bridge,
-}
-export type {
-  PlatformNetworkFetchRequest,
-  PlatformNetworkFetchResponse,
-  PlatformFileCreateFolderResult,
-  PlatformFileDeleteResult,
-  PlatformFileEntry,
-  PlatformFileListResult,
-  PlatformFilePreviewUrlResult,
-  PlatformFileReadBinaryResult,
-  PlatformFileReadPreviewResult,
-  PlatformFileRenameResult,
-  PlatformFileWriteResult,
-  PlatformStorageJsonReadResult,
-  PlatformStorageJsonRequest,
-  PlatformStorageJsonWriteRequest,
-  PlatformStorageJsonWriteResult,
-}
-
-const STANDALONE_SETTINGS_KEY = 'puredesktop:{{APP_SLUG}}:settings'
-
-export function isStandaloneDevMode(): boolean {
-  return import.meta.env.DEV && window.parent === window
-}
-
-function readStandaloneSettings(): AppSettings {
-  try {
-    const raw = window.localStorage.getItem(STANDALONE_SETTINGS_KEY)
-    return raw ? (JSON.parse(raw) as AppSettings) : {}
-  } catch {
-    return {}
-  }
-}
-
-export async function fetchAppSettings(): Promise<AppSettings> {
-  if (isStandaloneDevMode()) {
-    return readStandaloneSettings()
-  }
-
-  return getPlatformAppSettings(APP_SLUG) as Promise<AppSettings>
-}
+import { bridge } from '@puredesktop/puredesktop-ui-bridge/bridge/client'
+import {
+  getPlatformAppSettings,
+  updatePlatformAppSettings,
+} from '@puredesktop/puredesktop-ui-bridge/bridge/appSettings'
+import {
+  getPlatformPreferences,
+  patchPlatformPreferences,
+} from '@puredesktop/puredesktop-ui-bridge/bridge/preferences'
+import { networkFetch } from '@puredesktop/puredesktop-ui-bridge/bridge/network'
+import {
+  createPlatformFolder,
+  deletePlatformFile,
+  listPlatformFiles,
+  readPlatformFileBinary,
+  readPlatformFileBinaryDataUrl,
+  readPlatformFilePreview,
+  readPlatformFilePreviewUrl,
+  readPlatformTextFile,
+  renamePlatformFile,
+  writePlatformFileBinary,
+  writePlatformTextFile,
+} from '@puredesktop/puredesktop-ui-bridge/bridge/fs'
+import {
+  openPlatformFileDialog,
+  openPlatformFolderDialog,
+  openPlatformImageDialog,
+  savePlatformFolderDialog,
+} from '@puredesktop/puredesktop-ui-bridge/bridge/dialog'
+import {
+  readPlatformStorageJson,
+  writePlatformStorageJson,
+} from '@puredesktop/puredesktop-ui-bridge/bridge/storage'
+import { APP_SLUG } from '../constants'
+import type { AppSettings } from '../types'
+import type {
+  PlatformNetworkFetchRequest,
+  PlatformNetworkFetchResponse,
+} from '@puredesktop/puredesktop-ui-bridge/bridge/network'
+import type {
+  PlatformFileCreateFolderResult,
+  PlatformFileDeleteResult,
+  PlatformFileEntry,
+  PlatformFileListResult,
+  PlatformFilePreviewUrlResult,
+  PlatformFileReadBinaryResult,
+  PlatformFileReadPreviewResult,
+  PlatformFileRenameResult,
+  PlatformFileWriteResult,
+} from '@puredesktop/puredesktop-ui-bridge/bridge/fs'
+import type {
+  PlatformStorageJsonReadResult,
+  PlatformStorageJsonRequest,
+  PlatformStorageJsonWriteRequest,
+  PlatformStorageJsonWriteResult,
+} from '@puredesktop/puredesktop-ui-bridge/bridge/storage'
+
+export {
+  getPlatformAppSettings,
+  updatePlatformAppSettings,
+  getPlatformPreferences,
+  patchPlatformPreferences,
+  networkFetch,
+  createPlatformFolder,
+  deletePlatformFile,
+  listPlatformFiles,
+  readPlatformFileBinary,
+  readPlatformFileBinaryDataUrl,
+  readPlatformFilePreview,
+  readPlatformFilePreviewUrl,
+  readPlatformTextFile,
+  renamePlatformFile,
+  writePlatformFileBinary,
+  writePlatformTextFile,
+  openPlatformFileDialog,
+  openPlatformFolderDialog,
+  openPlatformImageDialog,
+  savePlatformFolderDialog,
+  readPlatformStorageJson,
+  writePlatformStorageJson,
+  bridge,
+}
+export type {
+  PlatformNetworkFetchRequest,
+  PlatformNetworkFetchResponse,
+  PlatformFileCreateFolderResult,
+  PlatformFileDeleteResult,
+  PlatformFileEntry,
+  PlatformFileListResult,
+  PlatformFilePreviewUrlResult,
+  PlatformFileReadBinaryResult,
+  PlatformFileReadPreviewResult,
+  PlatformFileRenameResult,
+  PlatformFileWriteResult,
+  PlatformStorageJsonReadResult,
+  PlatformStorageJsonRequest,
+  PlatformStorageJsonWriteRequest,
+  PlatformStorageJsonWriteResult,
+}
+
+const STANDALONE_SETTINGS_KEY = 'puredesktop:{{APP_SLUG}}:settings'
+
+export function isStandaloneDevMode(): boolean {
+  return import.meta.env.DEV && window.parent === window
+}
+
+function readStandaloneSettings(): AppSettings {
+  try {
+    const raw = window.localStorage.getItem(STANDALONE_SETTINGS_KEY)
+    return raw ? (JSON.parse(raw) as AppSettings) : {}
+  } catch {
+    return {}
+  }
+}
+
+export async function fetchAppSettings(): Promise<AppSettings> {
+  if (isStandaloneDevMode()) {
+    return readStandaloneSettings()
+  }
+
+  return getPlatformAppSettings(APP_SLUG) as Promise<AppSettings>
+}

package/template/src/components/AppShell.tsx

@@ -1,6 +1,6 @@
-import styled from 'styled-components'
-import { Heading } from '@puredesktop/puredesktop-ui-bridge/components/common/typography/Heading'
-import { Text } from '@puredesktop/puredesktop-ui-bridge/components/common/typography/Text'
+import styled from 'styled-components'
+import { Heading } from '@puredesktop/puredesktop-ui-bridge/components/common/typography/Heading'
+import { Text } from '@puredesktop/puredesktop-ui-bridge/components/common/typography/Text'
 import type { AppSettings } from '../types'
 
 const Root = styled.div`
@@ -22,12 +22,12 @@ export function AppShell({ settings }: AppShellProps): React.ReactElement {
       <Text>
         Start building in <code>src/components/AppShell.tsx</code>. Bridge boot
         is wired — AppFrame, settings load, and standalone browser dev all work.
-      </Text>
-      {Object.keys(settings).length > 0 ? (
-        <Text size="sm" tone="secondary">
-          Loaded {Object.keys(settings).length} setting key(s).
-        </Text>
-      ) : null}
+      </Text>
+      {Object.keys(settings).length > 0 ? (
+        <Text size="sm" tone="secondary">
+          Loaded {Object.keys(settings).length} setting key(s).
+        </Text>
+      ) : null}
     </Root>
   )
 }