@cartomancy/react

Animated, data-driven architectural schematic components for React: orreries, Sankey looms, astrolabes, chrono-helixes and more. Drawn like plates from a drafting table, from your own text or JSON. Deterministic and local: no AI, no API keys, no running costs.

npm install @cartomancy/react

import { MeridianOrrery, ChronoHelix, CartomancyBackground } from '@cartomancy/react';

export default function Page() {
  return (
    <>
      <MeridianOrrery theme="dark" height={520} />
      <ChronoHelix data="Roadmap 2027. Beta launch feeds Public API and Mobile App." seed={7} />
      <CartomancyBackground mode="tripartite" opacity={0.4}>
        <h1>Hello</h1>
      </CartomancyBackground>
    </>
  );
}

Components

<Cartomancy mode="…"> plus twelve named schematics:

| Codex I (drafting) | Codex II (systems) | | --- | --- | | ConvergenceBus | TripartiteSankey | | AlluvialCascade | ProgramBubbles | | PolarSchematic | CyberneticLoop | | ChordAstrolabe | ToroidalMegaring | | RhizomeTree | ChronoHelix | | Stratigraphic | MeridianOrrery |

Common props

| Prop | Type | Default | | | --- | --- | --- | --- | | data | string \| SemanticTopologyModel | sample | Your text (parsed locally) or a model | | preset | string | | One of the bundled sample documents | | theme | 'light' \| 'dark' | 'light' | Blueprint paper or night sheet | | seed | number | | Deterministic layout seed | | density | number | | Number of drawn entities | | height | number \| string | 480 | Width follows the container | | fit | 'content' \| 'world' | 'content' | Frame the drawing or the whole sheet | | colors | Partial<RenderTheme> | | e.g. { background: 'transparent', accent: '#e73f07' } | | interactive | boolean | true | Pan, zoom, hover, click to lock | | animate | boolean | motion pref | Off when the user prefers reduced motion |

A ref exposes getScene(), fit(), toSvg() and toPng() for exports. Components are marked 'use client' and pause their animation while off screen.

Made by Araskova Labs × Anvin P Shibu. Source: github.com/ARASKOVA-labs/Cartomancy. Licence: MIT + Commons Clause (free to use in your projects, including commercial ones; you may not sell Cartomancy itself). See LICENSE.