notionx

notionx is a pnpm monorepo for the Notion-powered Cloudflare stack behind the published @notionx/* packages. This repository is the framework source, not a deployable user app: it contains the reusable runtime, the scaffolder, the unscoped npm create shim, the skill installer, and the release tooling used to publish those packages to npm.

What Lives Here

• @notionx/core: the runtime and framework primitives for Cloudflare Workers
• @notionx/cli: the scaffolder and notionx maintenance CLI
• create-notionx: the unscoped shim behind npm create notionx
• @notionx/skill: the packaged notionx skill installer

End users should create a separate app repository with npm create notionx and deploy that generated project to Cloudflare. This monorepo stays focused on framework and release work.

Repository Layout

packages/notionx/                 # Published as @notionx/core
packages/notionx-cli/             # Published as @notionx/cli
packages/create-notionx/          # Published `npm create notionx` shim
packages/notionx-skill/           # Published skill installer
scripts/                          # Release and repository automation
docs/                             # Architecture, publishing, and design docs
skills/                           # Skill source material bundled by the installer

Key Docs

• Architecture overview: docs/architecture/notionx-package.md
• Create a new project: docs/architecture/creating-new-project.md
• Customize content sources: docs/architecture/customizing-content-source.md
• Upgrade generated projects: docs/architecture/upgrading-notionx.md
• Unified registry protocol (v2, planned): docs/architecture/registry-protocol.md
• Publish packages: docs/PUBLISHING.md
• Release notes: docs/architecture/notionx-changelog.md

Local Development

pnpm install
pnpm --filter @notionx/core build
pnpm --filter @notionx/cli test
pnpm --filter @notionx/skill test

Repository Checks

pnpm -r test
pnpm -r typecheck
pnpm -r lint
pnpm release:status