cordiverse/cordisPublic

What is cordis?

A highly extensible plugin framework and event system for building robust Node.js applications.

What does cordis do?

Cordis is a powerful and flexible architecture framework designed for building highly modular Node.js applications. It provides a robust dependency injection container, a sophisticated event lifecycle system, and a hot-reloadable plugin engine. The framework allows developers to structure their applications as a collection of independent, reusable services that can seamlessly communicate and depend on one another. It excels at managing complex state and configurations across multiple plugins, ensuring applications remain maintainable as they scale in complexity. It is particularly well-suited for building extensible bots, servers, and command-line tools where a plugin-driven architecture is critical for long-term flexibility.

Who is cordis for?

Ideal for TypeScript and Node.js developers building complex, long-running applications like chat bots or modular servers that require robust plugin architectures and dependency management. Users are expected to have a basic understanding of the relevant underlying technologies.

How do I get started with cordis?

npm install cordis

How popular is cordis on GitHub?

cordiverse/cordis has 9,001 stars and 565 forks on GitHub, and gained 175 stars in the last 7 days.

What license does cordis use?

cordiverse/cordis is released under the MIT license.

• Permissive license

  MIT

• Repeat trending

  13 trending appearances

Cordis is a powerful and flexible architecture framework designed for building highly modular Node.js applications. It provides a robust dependency injection container, a sophisticated event lifecycle system, and a hot-reloadable plugin engine. The framework allows developers to structure their applications as a collection of independent, reusable services that can seamlessly communicate and depend on one another. It excels at managing complex state and configurations across multiple plugins, ensuring applications remain maintainable as they scale in complexity. It is particularly well-suited for building extensible bots, servers, and command-line tools where a plugin-driven architecture is critical for long-term flexibility.

Ideal for TypeScript and Node.js developers building complex, long-running applications like chat bots or modular servers that require robust plugin architectures and dependency management. Users are expected to have a basic understanding of the relevant underlying technologies.

• Dependency injection: Manages complex service dependencies automatically, ensuring plugins load in the correct order with required resources.
• Sophisticated event system: Provides a rich lifecycle and event bus for seamless, decoupled communication between independent modules.
• Hot-reloadable plugins: Supports dynamically loading, unloading, and reloading plugins at runtime without restarting the entire application.
• Type-safe configuration: Leverages TypeScript to provide rigorous validation and autocomplete for plugin configuration schemas.
• Context isolation: Creates safe, isolated scopes for plugins to prevent memory leaks and unintended interference with global state.

Getting started: npm install cordis

1. Cordis 4.0.0-rc.10v4.0.0-rc.10Sep 8, 2026

   ## Breaking Changes - loader: `EntryTree.write()` is replaced by `EntryTree.commit(change: EntryChange)`. A subclass receives one `EntryChange` per tree-side mutation, carrying the entry id, its group, the new options, and the previous ones. ## Notable Changes This release improves `@cordisjs/plugin-hmr` in several areas: - A three-stage partial reload makes reloading safer and faster. - `ctx.hmr.watch()` lets a plugin hook its own files into the watcher and decide what a change does. - Config hot-reloading works without `loader.internal`. The reconciliation between the config file and the runtime tree in `@cordisjs/plugin-include` is redesigned: - The loader reports each tree-side mutation as a structured change, and include folds those into a journal. - A read three-way merges the journal against the file. Edits on disjoint entries and keys both survive. On a conflicting key the file wins, and the conflict is logged. - A write applies the journal's deltas onto the last known file content, guarded by a content pre-check and an atomic temp-file replace. Changes left by a failed write stay in the journal and are retried, down to a last flush on dispose. - Change

2. Cordis 4.0.0-rc.9v4.0.0-rc.9Aug 29, 2026

   ## Bug Fixes - **core:** dispatch symbol and prototype-named events (#51) - **core:** do not re-enter lifecycle from a failed outcome (#98) - **timer:** settle concurrent interval reads in order (#53) - **types:** widen optional properties for `exactOptionalPropertyTypes` (#68) --- ## 问题修复 - **core:** 修正以 symbol 或 `Object.prototype` 同名属性（如 `toString`）作为事件名时的派发 (#51) - **core:** 已失败的 fiber 不再因 epoch 变化重入生命周期，只能通过 `update()` 恢复 (#98) - **timer:** `ctx.interval()` 迭代器的并发 `next()` 调用按顺序结算，不再丢弃先前 pending 的 promise (#53) - **types:** 放宽可选属性类型以兼容 `exactOptionalPropertyTypes` (#68) --- ## Packages - `cordis`: 4.0.0-rc.8 → 4.0.0-rc.9 - `@cordisjs/plugin-include`: 1.0.4 → 1.0.5 - `@cordisjs/plugin-loader`: 1.0.0-rc.5 → 1.0.0-rc.6 - `@cordisjs/plugin-timer`: 1.1.2 → 1.1.3

• freeCodeCamp/freeCodeCamp

  freeCodeCamp.org's open-source codebase and curriculum. Learn math, programming, and computer science for free.

  456.7K stars · TypeScript

• openclaw/openclaw

  The AI that really does things. Any OS. Any Platform. The lobster way. 🦞

  391.3K stars · TypeScript

• anomalyco/opencode

  The open source coding agent.

  211.7K stars · TypeScript

• n8n-io/n8n

  Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

  206.7K stars · TypeScript

• microsoft/vscode

  Visual Studio Code

  193.5K stars · TypeScript

• firecrawl/firecrawl

  Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. 🔥

  188.6K stars · TypeScript