@atheory-ai/kitsune

Umbrella package for the Kitsune web-native frontend application kit.

@atheory-ai/kitsune is the main install target for applications that want Kitsune's runtime, browser custom elements, React adapter, theme helpers, development tools, and capability modules available from one package.

The root export is intentionally server-safe and re-exports the framework-neutral runtime from @atheory-ai/kitsune-core. Browser-only surfaces are available through explicit subpaths so server rendering and build tools do not accidentally register custom elements.

Install

pnpm add @atheory-ai/kitsune

For React integrations, install React as usual:

pnpm add @atheory-ai/kitsune react react-dom

Runtime

import { createKitRuntime } from '@atheory-ai/kitsune'

const runtime = createKitRuntime()
await runtime.start()

Browser Custom Elements

import '@atheory-ai/kitsune/app'
import '@atheory-ai/kitsune/ui'
import '@atheory-ai/kitsune/theme/tokens.css'

<kit-shell name="app">
  <kit-boundary surface="workspace" feature="prompts">
    <kit-card>
      <h2 slot="header">Prompt Review</h2>
      <p>Ready for approval.</p>
    </kit-card>
  </kit-boundary>
</kit-shell>

React

import { KitBoundary, KitShellProvider } from '@atheory-ai/kitsune/react'

export function App() {
  return (
    <KitShellProvider context={{ surface: 'app' }}>
      <KitBoundary surface="settings" feature="profile">
        <button data-meta-command="profile.save">Save</button>
      </KitBoundary>
    </KitShellProvider>
  )
}

Capability Modules

import { storageModule } from '@atheory-ai/kitsune/modules/storage'
import { validationModule } from '@atheory-ai/kitsune/modules/validation'

await runtime.install(storageModule({ namespace: 'app' }))
await runtime.install(validationModule())

Available module subpaths:

• @atheory-ai/kitsune/modules/storage
• @atheory-ai/kitsune/modules/analytics
• @atheory-ai/kitsune/modules/audit
• @atheory-ai/kitsune/modules/observability
• @atheory-ai/kitsune/modules/permissions
• @atheory-ai/kitsune/modules/flags
• @atheory-ai/kitsune/modules/validation
• @atheory-ai/kitsune/modules/search
• @atheory-ai/kitsune/modules/sync
• @atheory-ai/kitsune/modules/command-palette

Documentation

See the Kitsune docs at https://kitsune.atheory.ai.

License

Apache-2.0