@freeappstore/sdk 0.14.30 → 0.14.31

package/README.md

@@ -175,20 +175,41 @@ function App() {
 }
 ```
 
+### App shell
+
+Every app wraps itself in `Shell` from `@freeappstore/sdk/ui`: the topbar (FreeAppStore link, app name, text size, theme, sign-in / profile menu), the app's main navigation from `nav`, and an error boundary, loading fallback, toast region, offline banner and skip link around your screens. There is no paid tier, so the only gate is the optional sign-in gate (`requireAuth`).
+
+```tsx
+import { type NavItem, PageHeader, Shell, useToast } from '@freeappstore/sdk/ui';
+
+const NAV: NavItem[] = [
+  { label: 'Notes', href: '/', title: 'Notes' },
+  { label: 'Tags', href: '/tags', title: 'Tags — Notes' },
+];
+
+<Shell app={fas} appName="Notes" nav={NAV} onNavigate={navigate}>
+  <Screen />
+</Shell>
+
+// In a screen: its single h1, and feedback through the shell
+<PageHeader title="Tags" />
+const toast = useToast(); toast.show('Saved', { variant: 'success' });
+```
+
+`onNavigate` makes nav clicks client-side (scroll and focus are handled on route changes); without it the items are ordinary links. `FasShell` is the same component under its older name. Full reference: [docs/ui.md](../../docs/ui.md#shell-the-standard-app-frame).
+
 ### UI Components
 
 Drop-in React components. Import from `@freeappstore/sdk/ui`. Components use CSS custom properties (`--ink`, `--accent`, etc.) to blend into your app's theme.
 
 ```tsx
 import {
-  FasShell, Avatar, SignInButton, ThemeToggle, ProfileMenu, ProfilePage,
+  Shell, PageHeader, NavBar, useToast, useDocumentTitle, useOnline,
+  Avatar, SignInButton, ThemeToggle, ProfileMenu, ProfilePage,
   Spinner, Badge, Card, Tabs, Modal, ConfirmDialog, EmptyState,
   ProgressBar, SearchInput, ListRow, ErrorBoundary, KeyPrompt,
 } from '@freeappstore/sdk/ui';
 
-// Zero-config shell
-<FasShell app={fas} appName="My App"><MyApp /></FasShell>
-
 // Building blocks
 <Spinner size={24} />
 <Badge variant="success">Live</Badge>

package/dist/logger.d.ts

@@ -35,7 +35,7 @@ export interface BuildMeta {
     viewport: string;
     theme?: string | undefined;
 }
-export declare const SDK_VERSION = "0.14.29";
+export declare const SDK_VERSION = "0.14.30";
 export declare class Logger {
     private readonly appId;
     private readonly apiBase;

package/dist/logger.js

@@ -1,6 +1,6 @@
 // Must track package.json version — bumped on release. Guarded by version.test.ts
 // so a forgotten bump fails CI instead of silently misattributing telemetry.
-export const SDK_VERSION = '0.14.29';
+export const SDK_VERSION = '0.14.30';
 const MEMORY_LIMIT = 200;
 const STORAGE_LIMIT = 500;
 const STORAGE_KEY_PREFIX = 'fas_logs:';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@freeappstore/sdk",
-  "version": "0.14.30",
+  "version": "0.14.31",
   "description": "Browser SDK for apps on freeappstore.online — auth, per-user KV, shared counters, document collections, real-time rooms, API proxy, user API key vault, RBAC roles, React hooks, and 18 UI components.",
   "license": "MIT",
   "type": "module",