KatanaKit

Appearance

0
KatanaKit v6.13.0 is out

KatanaKitA sharp TypeScript service toolkit

Framework-agnostic, hexagonal and SSR-safe. HTTP with Safe Results, Zod validation, query cache, filesystem helpers, fake data and an OpenAI-compatible assistant.

Get Started
API Reference
$ npm i katanakit-js

Currently v6.13.0ReleasesGitHub

Why KatanaKit

Sharp tools, zero surprises

Safe Results

Fallible async calls return `{ data, error, ok }` instead of throwing — HTTP, filesystem and every adapter share the same contract.

Zod everywhere

`src/types` is inferred from Zod schemas and API adapters validate every response at the boundary, so malformed payloads never leak.

Framework adapters

React, Vue, Solid, Svelte, Angular and Nuxt bindings over the same TanStack Query Core engine bundled with the package.

Node/Bun toolkit

Filesystem and path helpers with native errno codes, plus optional lazy faker for reproducible seed data and fixtures.

Zero side effects

Importing any module is safe — no fetch calls, no console logs, no storage writes, no top-level Node built-ins.

SSR-safe

Every infrastructure service guards or falls back gracefully outside the browser; Node-only APIs load through dynamic import.

Documentation

Explore by domain

Nine self-contained sections. Start at the top or jump straight into the area you need.

IntroductionInstall KatanaKit, learn the Safe Result contract and how the hexagonal layout fits together.Getting StartedError HandlingArchitectureRoadmapServicesThe service reference: HTTP, DOM, storage, dates, observers, workers and more — one page each.HTTP ClientDOMStorageDatesLoggerHTTP & RESTTyped fetch with a TanStack Query cache, framework bindings and auth sessions.Query ClientFramework AdaptersBetter AuthRuntime & FilesystemNode and Bun helpers: filesystem with native errno codes, server adapter and seed fixtures.FilesystemBun AdapterFakerBrowser & DOMReactive watchers, DOM utilities and lightbox galleries.WatchPhotoSwipeUpgradesStep-by-step migration guides for every major release.v6v5v4v3v2UI KitKatana UI foundations: components, inventory and LLM-friendly context files.ComponentsInventoryHyperUISCSS FrameworkPure SCSS: design tokens, @apply composition, layout mixins and generated utilities.FoundationsMixinsUtilitiesReferenceReferenceEvery export generated from source, plus the complete release history.API ReferenceChangelog

Ready to build with KatanaKit?

Start with a working API client, then add validation and caching as your app grows.

Build your first API client Read the getting started guide

Released under the MIT License.

Copyright © Sergio Jurado