@stone-js/core
Version:
Stone.js core library, providing the kernel, factory, and context for building applications.
60 lines (40 loc) • 4.03 kB
Markdown
# Stone.js - Core
[](https://opensource.org/licenses/MIT)
[](https://www.npmjs.com/package/@stone-js/core)
[](https://www.npmjs.com/package/@stone-js/core)

[](https://github.com/stone-foundation/stone-js-core/actions/workflows/main.yml)
[](https://github.com/stone-foundation/stone-js-core/actions/workflows/release.yml)
[](https://sonarcloud.io/summary/new_code?id=stone-foundation_stone-js-core)
[](https://sonarcloud.io/summary/new_code?id=stone-foundation_stone-js-core)
[](./SECURITY.md)
[](https://github.com/stone-foundation/stone-js-core/security/code-scanning)
[](https://github.com/stone-foundation/stone-js-core/network/updates)
[](https://conventionalcommits.org)
A universal JavaScript/TypeScript core for building scalable, context-adaptive applications with reusable business logic, independent of runtime environments.
---
## Overview
**Stone.js Core** is the heart of the Stone.js framework, a context-aware, universal JavaScript/TypeScript framework designed to help you build scalable and portable applications that adapt to any runtime.
> With Stone.js, business logic is no longer tied to one environment.
> It becomes **reusable**, **composable**, and **context-resilient**.
Whether you're targeting a command-line interface, an HTTP server, a browser app, an AWS Lambda function, or an edge environment, `@stone-js/core` provides the foundational architecture to keep your logic consistent, modular, and fully decoupled from infrastructure.
## Why Stone.js Core?
- **Write once, run anywhere** — build your application logic independently of the environment.
- **Context-first architecture** — every runtime context (CLI, HTTP, cloud, serverless, FaaS, browser) becomes a plug-and-play adapter.
- **Universal lifecycle** — process events and produce responses in a unified flow.
- **No assumptions, full control** — fully customizable configuration, extensibility, and composition.
- **Framework without a framework** — use Stone.js with or without a frontend, backend, or transport protocol.
## What's Inside?
Stone.js Core provides the foundational building blocks that power the entire ecosystem:
- A flexible **context execution engine** (kernel) to handle app lifecycles.
- A universal **event system** that translates any platform input into structured intents.
- A **blueprint configuration model** for organizing app behavior and dependencies.
- A powerful, context-aware **middleware and handler core**.
- A runtime-independent foundation to power **modular, adaptive applications**.
## Learn More
This package is part of the Stone.js ecosystem, a modern JavaScript framework built around the Continuum Architecture.
Explore the full documentation: [https://stonejs.dev](https://stonejs.dev)
## API documentation
- [API](https://github.com/stone-foundation/stone-js-core/blob/main/docs/modules.md)
## Contributing
See [Contributing Guide](https://github.com/stone-foundation/stone-js-core/blob/main/CONTRIBUTING.md).