# cordis (cordiverse/cordis)

> Cordis is a meta-framework built around spatiotemporal composability, written in TypeScript for the Node.js ecosystem.

- GitHub: https://github.com/cordiverse/cordis
- GitHub.Locker page: https://github.locker/cordiverse/cordis
- Stars: 9.7K
- Language: TypeScript
- License: MIT
- Last push: 2026-11-04

## Questions and answers

Written by GitHub.Locker from the README and the repository; check the README below for details.

**Is it a framework or a library?**

It is presented as a framework (a meta-framework), so you build your application on top of it rather than dropping in a single utility function.

**What do I need before I start?**

Node.js and TypeScript, since the project is written in TypeScript and tagged for Node.js. The README names no other prerequisites.

**Is it safe to build on right now?**

Not yet for long-term production work. The author states the API is not stable and may change without notice.

**Who should build on this?**

Developers who want a plugin-style, composable architecture and can tolerate breaking API changes while the project matures.

**What is the core idea behind spatiotemporal composability?**

The README does not explain the concept itself. It points to an arXiv paper titled 'A Programming Paradigm for Spatiotemporal Composability', which is the best place to learn the reasoning behind the framework.

**How mature is the project?**

It was created in May 2022 and has about 9.7k GitHub stars. The author still describes it as under active development with an unstable API.

**What is it built with and aimed at?**

It is written in TypeScript, and its topics include nodejs and plugin, which suggests it targets Node.js applications with a plugin model.


---

## README (checked against GitHub 2026-11-06)

Source: https://github.com/cordiverse/cordis/blob/main/README.md

<div align="center">
  <h1 id="satori">Cordis</h1>
</div>

A Meta-Framework of Spatiotemporal Composability.

**Cordis is under active development. The API is not yet stable and may change without notice.**

- Paper: _A Programming Paradigm for Spatiotemporal Composability_ [[arXiv](https://arxiv.org/abs/2608.25512)] [[repository](https://github.com/cordiverse/paper)]
- Documentation: [cordis-primer](https://deepseek-harness.github.io/deepseek-harness/reference/cordis-primer) (official documentation is still under construction)