@krantho/node 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Descoped
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,53 @@
-# Temporary Holding Version
+# @krantho/node
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+One-install convenience bundle for building a krantho site with **Vite / Express
+/ Node**.
+
+```bash
+pnpm add @krantho/node @krantho/ui-react
+```
+
+This bundle deliberately does **not** include a UI library — pick one yourself
+(`@krantho/ui-react`, `@krantho/ui-svelte`, `@krantho/ui-mui`, or
+`@krantho/ui-tailwind`). Everything else a typical Node project needs is included:
+
+| Bundled package | Role |
+|-----------------|------|
+| `@krantho/server-node` | Vite / Express / Node adapter |
+| `@krantho/studio` | Studio SPA (served at `/studio`) |
+| `@krantho/media-local` | Local disk file store for media (`media.provider: 'local'`) |
+| `@krantho/seo` | Schema.org archetypes, JSON-LD, rich result tooling |
+
+The content engine, schema system, API, and SQLite/filesystem persistence come in
+transitively through `@krantho/server-node`.
+
+This is a **dependency-only** package — it has no runtime code of its own. Import
+APIs from the underlying packages directly:
+
+```ts
+import { createHandler } from '@krantho/server-node'
+import { composeFromConfig } from '@krantho/seo'
+```
+
+Under a strict, non-hoisted `node_modules` layout (pnpm's default) a transitive
+dependency cannot be imported by name. List the packages your code imports —
+typically `@krantho/config`, `@krantho/schema` and `@krantho/server-node` — as direct
+dependencies too.
+
+## SEO is included but opt-in
+
+`@krantho/seo` is installed but only activated when `krantho.config.ts` carries a
+`seo` block. Zero overhead if unused.
+
+## Postgres
+
+The default persistence is SQLite. For Postgres, add the adapter and driver:
+
+```bash
+pnpm add @krantho/node @krantho/persistence-postgres postgres
+```
+
+## Prefer modular installs?
+
+The bundle exists for a fast start. Power users can install the individual
+packages (`@krantho/server-node`, …) and swap any piece.

package/package.json

@@ -1,6 +1,23 @@
 {
   "name": "@krantho/node",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.0",
+  "description": "One-install krantho bundle for Vite / Express / Node — server adapter, Studio, media, and SEO. Pick a UI library separately.",
+  "license": "MIT",
+  "homepage": "https://krantho.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/descoped/krantho.git",
+    "directory": "packages/node"
+  },
+  "bugs": {
+    "url": "https://github.com/descoped/krantho/issues"
+  },
+  "author": "oranheim",
+  "type": "module",
+  "dependencies": {
+    "@krantho/server-node": "1.0.0",
+    "@krantho/studio": "1.0.0",
+    "@krantho/media-local": "1.0.0",
+    "@krantho/seo": "1.0.0"
+  }
 }