Introduction

What Katalyst is

Katalyst is a React + TypeScript admin template.

It combines:

• A production-oriented project structure (routing, modules, DI, config)
• Shared primitives (hooks) for common admin interactions
• Thin shared UI components built on top of those primitives

Who it is for

Katalyst is for teams building internal tools or admin surfaces that need:

• Repeatable interaction behavior (bulk actions, inline edits, confirmations, keyboard flows)
• A consistent UI foundation (Radix + shadcn-style primitives)
• A module-based structure for features

What problems it solves

• Avoids one-off implementations of recurring admin interactions
• Encourages a consistent “logic in hooks, UI in components” split
• Helps you compose primitives into higher-level patterns without inventing new abstractions

How to approach the docs

By learning path

1. Getting Started — Understand the architecture and project structure
2. Primitives — Learn the behavioral hooks: useBulkSelection, useInlineEdit, useConfirmation, useKeyboardShortcut, useCommandPalette
3. Patterns — See how primitives compose into workflows under Patterns
4. Components — Explore thin shared UI layers like ConfirmDialog, InlineEditable, CommandPalette

By use case

I want to...	Start here
Understand the architecture	Architecture & Philosophy
Add bulk selection to a table	useBulkSelection → Bulk Actions pattern
Add inline editing	useInlineEdit → Inline Editing pattern
Add keyboard shortcuts	useKeyboardShortcut
Add a command palette	useCommandPalette → CommandPalette component
Add confirmation dialogs	useConfirmation → ConfirmDialog component
Add drag and drop	useDragAndDrop
Add filtering/search	useFilter
Use only UI components	UI Components (shadcn)

If you're trying to solve a concrete UI problem, start in Patterns and follow the links back to the primitives.