@ossy/platform 0.0.1-alpha.1 → 0.0.1-alpha.2

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## 0.0.1-alpha.2 (2026-03-29)
+
+**Note:** Version bump only for package @ossy/platform
+
+
+
+
+
 ## 0.0.1-alpha.1 (2026-03-29)
 
 **Note:** Version bump only for package @ossy/platform
@@ -13,6 +21,10 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 
 # Changelog
 
+## Unreleased
+
+- Platform home route ships from **`src/platform/home.page.js`**; sites add **`@ossy/platform`** to **`modules`** (formerly `pagesModules`) and provide **`src/page-shell.jsx`** (see README).
+
 ## 0.0.1-alpha.0
 
 - Initial extract from `website-ossy`: `Definition`, `PlatformResourceTemplates`, `PlatformHomeBody`, `platformHomeMetadata`.

package/README.md

@@ -11,6 +11,7 @@ npm install @ossy/platform
 Peer dependencies (your app should already include them):
 
 - `react`
+- `@ossy/connected-components` (for **`usePageShell`** on module pages)
 - `@ossy/design-system`
 - `@ossy/router-react`
 - `@ossy/sdk-react`
@@ -18,8 +19,11 @@ Peer dependencies (your app should already include them):
 ## Use in a website
 
 1. Spread **`PlatformResourceTemplates`** into your app `resourceTemplates` (and sync to the API via publish / cms upload).
-2. Add a page that wraps **`PlatformHomeBody`** in your shell layout and export **`platformHomeMetadata`**.
-3. Register **`Definition`** in your navigation / module registry.
+2. Add **`@ossy/platform`** to **`modules`** in `src/config.js` so **`src/platform/home.page.js`** is picked up (JSX-free so Rollup can parse `.page.js`; **`*.page.jsx`** works under `src/` for other files if the bundler accepts JSX there).
+3. Add **`src/page-shell.jsx`** (or `.js`) that default-exports your site layout (e.g. ossy.se re-exports **`Layout`**). Module pages call **`usePageShell()`** so they do not depend on site paths.
+4. Register **`Definition`** in your navigation / module registry.
+
+**Surface in this package:** **`*.page.*`** files may live anywhere under **`src/`**; resources are exported from the package root (`PlatformResourceTemplates`, constants). **API routes** and **worker tasks** can follow the same `*.api.js` / `*.task.js` conventions under the site `src/` today; pulling those from installable modules can mirror **`modules`** later (e.g. shared discovery for APIs / worker tasks).
 
 ## Publishing
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ossy/platform",
-  "version": "0.0.1-alpha.1",
+  "version": "0.0.1-alpha.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ossy-se/ossy.git",
@@ -30,10 +30,11 @@
     "registry": "https://registry.npmjs.org"
   },
   "peerDependencies": {
+    "@ossy/connected-components": ">=0.14.0",
     "@ossy/design-system": ">=0.14.0",
     "@ossy/router-react": ">=0.14.0",
     "@ossy/sdk-react": ">=0.14.0",
     "react": ">=19.0.0"
   },
-  "gitHead": "1da35d94f324f917d5ea790f838ce8e50214730e"
+  "gitHead": "280ce1f62d7daf721909ac5eabe4181991e00456"
 }

package/src/platform/home.page.js

@@ -0,0 +1,11 @@
+import React from 'react'
+import { usePageShell } from '@ossy/connected-components'
+import { PlatformHomeBody } from '../PlatformHomeBody.jsx'
+import { platformHomeMetadata } from '../platformHomeMetadata.js'
+
+export const metadata = platformHomeMetadata
+
+export default function PlatformHomePage () {
+  const Shell = usePageShell()
+  return React.createElement(Shell, null, React.createElement(PlatformHomeBody))
+}