Initial: solid-apps catalog + first app (todos)

Catalog of working LOSOS apps. Each entry is a single-HTML-file
application built on the LION + urn-solid + solid-schema + solid-panes +
LOSOS stack, with an app.json catalog manifest declaring the urn:solid
types it handles.

Scaffolding (mirrors urn-solid/solid-schema/solid-panes patterns):
- schema/app.schema.json — meta-schema for app.json
- scripts/validate.js — manifest schema check + entry-file existence
- scripts/build.js — emits index.json catalog + reverse-index by type
- index.html — catalog landing page that fetches index.json and lists apps
- README.md, SKILL.md — discovery docs (5th SKILL.md in the stack)

First app — todos:
- todos/index.html — Tracker with three sample Vtodos inline
- todos/app.json — claims urn:solid:Tracker + urn:solid:Vtodo
- Composes panes: todo-pane (Tracker), schema-pane (Vtodo edit),
  schema-view (Vtodo display), source-pane (raw JSON)
- Uses autoSchema for the schema-driven panes; bespoke todo-pane fires
  off canHandle('Tracker') as before
- Demonstrates the "registry routes a type to a bespoke pane" feature
  that wasn't shippable before because Tracker wasn't in the registries

Enabled by the prior three commits across the chain:
- urn-solid: added urn:solid:Tracker (536 terms)
- solid-schema: added Tracker schema (8 schemas)
- solid-panes: added Tracker manifest pointing at todo-pane.js (8 manifests)

Stack now five repos, all five interlinked, todos works end-to-end at
solid-apps.github.io/todos/.

Author: melvincarvalho

.gitignore

@@ -0,0 +1,4 @@
+node_modules/
+.DS_Store
+.claude/
+*.log

README.md

@@ -0,0 +1,45 @@
+# solid-apps
+
+Working LOSOS applications built on the [LION](https://linkedobjects.org/) + [urn-solid](https://urn-solid.github.io/) + [solid-schema](https://solid-schema.github.io/) + [solid-panes](https://solid-panes.github.io/) + [LOSOS](https://losos.org/) stack.
+
+Each app is a single-HTML-file application that handles one or more `urn:solid:` types. Open the URL to use it.
+
+## Apps
+
+```
+todos/  →  https://solid-apps.github.io/todos/
+```
+
+(Catalog at https://solid-apps.github.io/ updates as more apps land.)
+
+## Repo layout
+
+```
+<slug>/                     One app per directory
+  index.html                The app entry point (open this URL to use it)
+  app.json                  Catalog manifest (name, description, types handled, etc.)
+  ...                       Custom panes, data, assets as needed
+schema/app.schema.json      Meta-schema for app.json
+scripts/validate.js         Validate every app.json + check entry exists
+scripts/build.js            Generate index.json catalog + reverse-index by type
+index.html                  Catalog landing page
+index.json                  Generated: slug → catalog entry
+reverse-index.json          Generated: urn:solid:Type → array of app slugs
+corpus.jsonl                Generated: every manifest, one per line
+```
+
+## Adding an app
+
+```bash
+mkdir my-app
+# write my-app/app.json (see schema/app.schema.json)
+# write my-app/index.html (the actual application)
+npm run validate
+npm run build
+git commit -am "add: my-app"
+git push
+```
+
+## License
+
+[AGPL-3.0](LICENSE)

SKILL.md

@@ -0,0 +1,110 @@
+---
+name: solid-apps
+description: Find working LOSOS apps that handle a urn:solid type, or contribute a new app to the catalog. Use when the user wants a real application (not just a demo) for some Solid data, or when packaging a LOSOS app for discoverability.
+---
+
+# solid-apps
+
+Working LOSOS applications, one per directory. Each is a single-HTML-file app built on the full stack (LION + urn-solid + solid-schema + solid-panes + LOSOS) and ships with a catalog manifest declaring what `urn:solid:` types it handles.
+
+```
+LION  →  urn-solid  →  solid-schema  →  solid-panes  →  LOSOS  →  solid-apps (this)
+```
+
+## When to use this skill
+
+- The user has Solid data of some `urn:solid:` type and wants a ready-to-use app for it.
+- The user is building a new LOSOS app and wants to publish it for discovery.
+- The user asks "what apps work with my pod?" or "what handles `urn:solid:X`?"
+
+## Finding an app for a type
+
+Reverse index maps each handled type to the apps that handle it:
+
+```
+curl -s https://solid-apps.github.io/reverse-index.json
+# { "urn:solid:Tracker": ["/todos/"], "urn:solid:Vtodo": ["/todos/"], ... }
+```
+
+Catalog index has the full manifests: `https://solid-apps.github.io/index.json`.
+
+## Anatomy of an app
+
+```
+todos/
+  app.json        Catalog manifest (required)
+  index.html      The app — opens at https://solid-apps.github.io/todos/
+  ...             Optional: custom panes, sample data, screenshots
+```
+
+`app.json` shape (validated by `schema/app.schema.json`):
+
+```json
+{
+  "name": "Todos",
+  "description": "A list of tasks. Built on LOSOS's bespoke todo-pane via the urn:solid:Tracker manifest.",
+  "entry": "./index.html",
+  "types": ["urn:solid:Tracker", "urn:solid:Vtodo"],
+  "icon": "\u2705",
+  "author": "Melvin Carvalho",
+  "status": "stable",
+  "added": "2026-04-19"
+}
+```
+
+## What's in an app's index.html
+
+A typical app composes the stack:
+
+```html
+<!-- 1. JSON-LD data island, inline (or load from a pod via ?uri= query param) -->
+<script type="application/ld+json">{ "@type": "Tracker", "issue": [...] }</script>
+
+<!-- 2. Panes — declare which to load (LOSOS picks via canHandle) -->
+<script type="module" data-pane src="https://losos.org/panes/todo-pane.js"></script>
+<script type="module" data-pane src="https://losos.org/panes/schema-pane.js"></script>
+<script type="module" data-pane src="https://solid-panes.github.io/schema-view.js"></script>
+<script type="module" data-pane src="https://losos.org/panes/source-pane.js"></script>
+
+<!-- 3. Mount point -->
+<div id="losos"></div>
+
+<!-- 4. Boot: autoSchema patches $schema based on @type, then shell -->
+<script type="module">
+  import { autoSchema } from 'https://solid-panes.github.io/auto-schema.js'
+  await autoSchema()
+  await import('https://losos.org/losos/shell.js')
+</script>
+```
+
+That's the universal pattern. What changes between apps is mostly: the data, which panes are declared, and the type the manifest claims.
+
+## Adding a new app
+
+1. **Make sure the types you handle exist in urn-solid + have schemas in solid-schema + have manifests in solid-panes.** If not, add them upstream first.
+2. Create `<slug>/` with `app.json` and `index.html`.
+3. `npm run validate && npm run build`.
+4. Commit + push.
+5. The catalog (https://solid-apps.github.io/) and reverse-index update automatically.
+
+## Don't
+
+- Don't list types in `app.json#types` that aren't in urn-solid.
+- Don't ship an app that depends on private LOSOS APIs — only use the URL-stable ones (`losos.org/losos/*.js`, `losos.org/panes/*.js`).
+- Don't bundle LOSOS or panes into the app — fetch them at the stable URLs so updates propagate.
+- Don't put pane *implementations* in solid-apps — they belong in LOSOS or solid-panes. solid-apps composes; it doesn't define new core machinery.
+
+## Reference URLs
+
+- Catalog: https://solid-apps.github.io/index.json
+- By-type index: https://solid-apps.github.io/reverse-index.json
+- Corpus: https://solid-apps.github.io/corpus.jsonl
+- Manifest schema: https://solid-apps.github.io/schema/app.schema.json
+- Site: https://solid-apps.github.io/
+
+## Related skills
+
+- `urn-solid` — vocabulary registry
+- `solid-schema` — type contracts
+- `solid-panes` — pane registry (which pane handles which type)
+- `losos` — runtime

corpus.jsonl

@@ -0,0 +1 @@
+{"name":"Todos","description":"A list of tasks. Built on LOSOS's bespoke todo-pane via the urn:solid:Tracker manifest.","entry":"./index.html","types":["urn:solid:Tracker","urn:solid:Vtodo"],"icon":"✅","author":"Melvin Carvalho","status":"stable","added":"2026-04-19"}

index.html

@@ -0,0 +1,80 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>solid-apps</title>
+<style>
+body { font-family: Georgia, serif; max-width: 720px; margin: 2rem auto; padding: 0 1rem; color: #2c2c2c; background: #fafaf8; }
+header a { color: #888; text-decoration: none; margin-right: 1.2rem; }
+h1 { margin-bottom: 0.25rem; }
+.subtitle { color: #888; margin-top: 0; }
+ul { list-style: none; padding: 0; }
+li { background: #fff; border: 1px solid #e5e3de; border-radius: 6px; padding: 16px; margin: 0.75rem 0; }
+li a.title { color: #1a5276; text-decoration: none; font-weight: 600; font-size: 1.05em; }
+li .types { color: #888; font-family: monospace; font-size: 0.85em; margin-top: 6px; }
+li .icon { float: right; font-size: 1.5em; opacity: 0.7; }
+.urn { font-family: monospace; background: #f0efeb; padding: 0.1em 0.4em; border-radius: 3px; }
+</style>
+</head>
+<body>
+<header>
+  <a href="/">solid-apps</a>
+  <a href="/index.json">catalog</a>
+  <a href="/reverse-index.json">by type</a>
+  <a href="https://urn-solid.github.io/">urn-solid</a>
+  <a href="https://solid-schema.github.io/">solid-schema</a>
+  <a href="https://solid-panes.github.io/">solid-panes</a>
+</header>
+
+<h1>solid-apps</h1>
+<p class="subtitle">Working LOSOS applications, each built on the LION + urn-solid + solid-schema + solid-panes + LOSOS stack. Open any URL to use the app.</p>
+
+<h2>Apps</h2>
+<ul id="catalog">
+  <li><em>Loading…</em></li>
+</ul>
+
+<h2>What this is</h2>
+<p>Each app is a single-HTML-file LOSOS application that handles one or more <span class="urn">urn:solid:</span> types. Schema-driven where possible (form auto-generated from the type's JSON Schema), bespoke where warranted (e.g. Tracker uses LOSOS's native todo-pane for the list view).</p>
+
+<p>The whole stack visible at one click per app:</p>
+<ol>
+  <li><strong>LION</strong> — the data is just JSON-LD</li>
+  <li><strong>urn-solid</strong> — bare type names like <code>Tracker</code> default to <code>urn:solid:Tracker</code></li>
+  <li><strong>solid-schema</strong> — JSON Schema describes the shape</li>
+  <li><strong>solid-panes</strong> — manifest routes the type to the right pane</li>
+  <li><strong>LOSOS</strong> — runtime renders panes, syncs writes back to the pod</li>
+</ol>
+
+<footer style="margin-top: 3rem; color: #888; font-size: 0.85em;">
+  <p><a href="https://github.com/solid-apps/solid-apps.github.io">github.com/solid-apps/solid-apps.github.io</a></p>
+</footer>
+
+<script>
+(async () => {
+  const list = document.getElementById('catalog')
+  try {
+    const res = await fetch('/index.json')
+    const cat = await res.json()
+    const entries = Object.entries(cat)
+    list.innerHTML = ''
+    if (!entries.length) { list.innerHTML = '<li><em>No apps yet.</em></li>'; return }
+    for (const [slug, app] of entries) {
+      const li = document.createElement('li')
+      li.innerHTML = `
+        <span class="icon">${app.icon || ''}</span>
+        <a class="title" href="${app.entry}">${app.name}</a>
+        <div>${app.description}</div>
+        <div class="types">${app.types.map(t => `<span class="urn">${t}</span>`).join(' ')}</div>
+      `
+      list.appendChild(li)
+    }
+  } catch {
+    list.innerHTML = '<li><em>Failed to load catalog.</em></li>'
+  }
+})()
+</script>
+
+</body>
+</html>

index.json

@@ -0,0 +1,14 @@
+{
+  "todos": {
+    "name": "Todos",
+    "description": "A list of tasks. Built on LOSOS's bespoke todo-pane via the urn:solid:Tracker manifest.",
+    "entry": "/todos/index.html",
+    "types": [
+      "urn:solid:Tracker",
+      "urn:solid:Vtodo"
+    ],
+    "icon": "✅",
+    "status": "stable",
+    "manifest": "/todos/app.json"
+  }
+}

package-lock.json

@@ -0,0 +1,20 @@
+{
+  "name": "@solid-apps/registry",
+  "version": "0.0.1",
+  "description": "Catalog of LOSOS apps — each entry is a working application built on the urn-solid + solid-schema + solid-panes + LOSOS stack.",
+  "type": "module",
+  "scripts": {
+    "validate": "node scripts/validate.js",
+    "build": "node scripts/build.js"
+  },
+  "devDependencies": {
+    "ajv": "^8.17.0",
+    "ajv-formats": "^3.0.1"
+  },
+  "license": "AGPL-3.0",
+  "homepage": "https://solid-apps.github.io",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/solid-apps/solid-apps.github.io.git"
+  }
+}

package.json

@@ -0,0 +1,8 @@
+{
+  "urn:solid:Tracker": [
+    "/todos/"
+  ],
+  "urn:solid:Vtodo": [
+    "/todos/"
+  ]
+}