exhuma

Exhuma

The Universal Kinetic Component Platform & Multi-Framework Registry. 20 physics-driven primitives, 13 frontend ecosystems, zero layout thrashing, and zero runtime lock-in.

Exhuma is an open-source, universal UI component platform delivering tactile, physics-based interactions and responsive layout engines. Instead of locking you into a single framework or heavyweight runtime, Exhuma distributes canonical, zero-dependency source code across 13 frontend ecosystems via a dedicated CLI.

✨ Key Architectural Guarantees

• 20 Audited Kinetic Primitives: From 3D sticky stacking cards and elastic magnetic buttons to shared-element morphing tabs and comparison diff sliders.
• 13 Framework Ecosystems: Full implementation parity across React, Next.js, Vue 3, Nuxt, Svelte 5, SvelteKit, Angular 18+, SolidJS, Astro, Laravel Blade, Vanilla JS, WordPress Gutenberg, Web Components, React Native, and Flutter.
• $\Omega(1)$ Layout Thrashing Protection: Pure compositor-driven execution utilizing transform and opacity GPU layers to ensure sustained 60fps/120fps motion without triggering forced synchronous layouts.
• Deterministic Lifecycle Teardowns: Strict, verified event listener detachment, ResizeObserver / IntersectionObserver disconnections, and zero memory leaks upon unmount.
• Tailwind CSS v4 & Zero-Flash Theming: Semantic CSS variables with native dark/light mode support, zero visual flashes, and instant hydration.
• Zero-Lock-in CLI Distribution: Own your source code. Copy directly into your codebase with npx exhuma add <component>.

📦 Packages in the Monorepo

🚀 Quickstart

Option A: Use the Universal CLI (Recommended)

Initialize Exhuma in your existing project:

npx exhuma init

Add any of the 20 components directly into your codebase:

# Add to your current project (auto-detects framework)
npx exhuma add stacking-cards

# Explicitly target a specific ecosystem flavor
npx exhuma add floating-dock --flavor=svelte
npx exhuma add magnetic-button --flavor=vue
npx exhuma add comparison-slider --flavor=flutter

# Add all components
npx exhuma add --all

List all available canonical components and categories:

npx exhuma list

Option B: Scaffold a Fresh Project with create-exhuma

npm create exhuma@latest
# or
pnpm create exhuma
# or
bun create exhuma

Option C: Install Monorepo Packages

# Install flagship unified package
pnpm add @fleect/exhuma

# Or targeted standalone packages
pnpm add @fleect/exhuma-cards @fleect/exhuma-layouts

import { StackingCards } from '@fleect/exhuma/cards';
import { CssMasonry } from '@fleect/exhuma/layouts';

export default function Page() {
  return (
    <CssMasonry columns={3} gap='1.5rem'>
      <StackingCards topStart={90} topIncrement={24}>
        <div className='card'>Card 1</div>
        <div className='card'>Card 2</div>
      </StackingCards>
    </CssMasonry>
  );
}

🧩 Complete Component Inventory (19 Primitives)

🌐 Supported Framework Ecosystems

🛠️ Monorepo Development & Quality Gates

This repository is governed by strict automated quality gates powered by Turborepo, pnpm, and Vitest:

# Clone the repository
git clone https://github.com/Fleect/exhuma.git
cd exhuma

# Install all workspace dependencies
pnpm install

# Build registry, packages, and showcase
pnpm run build

# Run entire test suite (636 tests across 20 suites)
pnpm test

# Run TypeScript typechecks across all packages
pnpm typecheck

# Verify architecture boundaries, configs, and links
pnpm check:all

# Start local interactive documentation showcase
pnpm dev

📖 Documentation & Resources

• Exhuma Documentation Hub — Monorepo engineering guides and specifications.
• Architecture & Universal Component Model — Technical deep-dive into UCM design.
• Engineering Principles & Performance — Compositor rules and mathematical guarantees.
• Future Components Roadmap — Post-beta component roadmap.
• Interactive Showcase & Studio — Live interactive documentation.

📄 License

MIT © Fleect — A Fleect Artifact.