@ossy/apps

Apps feature package for the Ossy platform — application catalog UI, app-config schemas, and domain lookup/registration actions.

What's included

Pages

| File | Page id | Default paths | |---|---|---| | apps.page.jsx | apps/home | /apps (en), /appar (sv) |

The home page uses the design-system Page layout with a New App action that opens the create-document flow with schemaId.

Schemas (ADR 0006)

| Schema | Id | Purpose | |---|---|---| | App config | @ossy/apps/schema/app-config | Deployment config (domain, platformId, app name, managed domain ref, image, environment, notes) |

Document instances are stored under /@ossy/apps/ (see the location export in locations.js).

Actions

| Action | Task | Access | Purpose | |---|---|---|---| | @ossy/apps/actions/find-by-domain | @ossy/apps/tasks/find-by-domain | public | Resolve workspace from a managed domain name | | @ossy/apps/actions/register-domain | @ossy/apps/tasks/register-domain | workspace | Register a managed domain for the workspace |

Domain tasks use @ossy/domains/schema/managed-domain and ResourceStream / commitResource from @ossy/resources.

APIs

| File | Route | Invokes | |---|---|---| | ask.api.js | App lookup by domain | @ossy/apps/actions/find-by-domain | | register.api.js | Domain registration | @ossy/apps/actions/register-domain |

Exports

| Export | Description | |---|---| | location | Workspace storage path (/@ossy/apps/) | | Definition | Feature metadata (statuses: ['beta'], entitlementRequired: false) |

Usage

npm install @ossy/apps
npm run build

import { location } from '@ossy/apps'

const schemaId = '@ossy/apps/schema/app-config'
// @create-document?location=/@ossy/apps/&schemaId=@ossy/apps/schema/app-config

Migration from resource templates

| Before | After | |---|---| | @ossy/app/config | @ossy/apps/schema/app-config | | templateId query param | schemaId query param | | apps/actions/find-by-domain | @ossy/apps/actions/find-by-domain | | apps/actions/register-domain | @ossy/apps/actions/register-domain | | @ossy/domain/managed (in domain tasks) | @ossy/domains/schema/managed-domain |

Dependencies

| Package | Role | |---|---| | @ossy/design-system | Page and UI components | | @ossy/domains | Managed domain location and schema id | | @ossy/router-react | Page routing | | @ossy/sdk-react | Async status helpers | | react | UI |