https://github.com/stone-foundation/stone-js-core

Core of the Stone.js framework, provides the Continuum Architecture foundation, lifecycle management, pipelines, events, and context-aware logic powering universal JavaScript applications.
https://github.com/stone-foundation/stone-js-core

context-aware continuum-architecture javascript official-stonejs stone-foundation stonejs stonejs-core typescript

Last synced: 5 days ago
JSON representation

Core of the Stone.js framework, provides the Continuum Architecture foundation, lifecycle management, pipelines, events, and context-aware logic powering universal JavaScript applications.

• Host: GitHub
• URL: https://github.com/stone-foundation/stone-js-core
• Owner: stone-foundation
• License: mit
• Created: 2023-09-16T03:08:58.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2026-06-12T22:01:07.000Z (5 days ago)
• Last Synced: 2026-06-13T00:05:12.347Z (5 days ago)
• Topics: context-aware, continuum-architecture, javascript, official-stonejs, stone-foundation, stonejs, stonejs-core, typescript
• Language: TypeScript
• Homepage: https://stonejs.dev
• Size: 1.21 MB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS
  • Security: SECURITY.md

Awesome Lists containing this project

README

          
# Stone.js - Core

[![npm](https://img.shields.io/npm/l/@stone-js/core)](https://opensource.org/licenses/MIT)

[![npm](https://img.shields.io/npm/v/@stone-js/core)](https://www.npmjs.com/package/@stone-js/core)

[![npm](https://img.shields.io/npm/dm/@stone-js/core)](https://www.npmjs.com/package/@stone-js/core)

![Maintenance](https://img.shields.io/maintenance/yes/2026)

[![Build Status](https://github.com/stone-foundation/stone-js-core/actions/workflows/main.yml/badge.svg)](https://github.com/stone-foundation/stone-js-core/actions/workflows/main.yml)

[![Publish Package to npmjs](https://github.com/stone-foundation/stone-js-core/actions/workflows/release.yml/badge.svg)](https://github.com/stone-foundation/stone-js-core/actions/workflows/release.yml)

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=stone-foundation_stone-js-core&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=stone-foundation_stone-js-core)

[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=stone-foundation_stone-js-core&metric=coverage)](https://sonarcloud.io/summary/new_code?id=stone-foundation_stone-js-core)

[![Security Policy](https://img.shields.io/badge/Security-Policy-blue.svg)](./SECURITY.md)

[![CodeQL](https://github.com/stone-foundation/stone-js-core/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/stone-foundation/stone-js-core/security/code-scanning)

[![Dependabot Status](https://img.shields.io/badge/Dependabot-enabled-brightgreen.svg)](https://github.com/stone-foundation/stone-js-core/network/updates)

[![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](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).