Gravito Framework 🌌

Gravito is a modular, high-performance TypeScript framework built for the modern web. It leverages the Galaxy Architecture—a unique approach inspired by celestial mechanics to manage lifecycle, extensions (Orbits), and domain-specific plugins (Satellites).

Version 1.0 is here! Build complex e-commerce systems by simply composing modules.

🌟 The Galaxy Architecture

Gravito is built on the principle of "Rigorous Core, Flexible Perimeter." It strictly enforces DDD (Domain-Driven Design) and Clean Architecture internally while providing a minimalist experience for developers.

Micro-Kernel (PlanetCore): A self-developed, ultra-lightweight engine that manages hooks and lifecycle events.
Orbits (Infrastructure): Strategic extensions (Database, Auth, Messaging) that "orbit" the core, providing essential resources.
Satellites (Domain Plugins): Self-contained business units (Catalog, Cart, Payment) that implement specific domains using Clean Architecture.

🚀 E-Commerce 1.0: Manifest-Driven Assembly

The 1.0 release introduces "MDD" (Manifest-Driven Development). You can now assemble a full-featured e-commerce site by simply declaring what you need.

The "Three-File" Rule

package.json: Add your satellites.
gravito.config.ts: Declare your features.
entry-server.ts: One line to ignite the entire ecosystem.

Example Configuration

// gravito.config.ts
export default {
  name: 'Flagship Store',
  modules: [
    'catalog',    // Products & Variants
    'membership', // Auth & User Profiles
    'analytics',  // Data & Charts
    'support',    // Real-time Chat
    'cms'         // News & Announcements
  ]
};

📦 Core Ecosystem

Gravito provides a rich set of official modules designed to work together seamlessly:

Foundation Layer

Package	Module	Description
`@gravito/core`	PlanetCore	The micro-kernel with Hooks & IoC Container.
`@gravito/photon`	Photon	High-performance HTTP engine (Hono-based).
`@gravito/atlas`	Atlas	Advanced ORM with migrations & Active Record.
`@gravito/signal`	Signal	The central Event Bus for cross-module events.

Domain Satellites (Business Logic)

Package	Domain	Feature
`@gravito/satellite-catalog`	Catalog	Product management, categories, and inventory.
`@gravito/satellite-membership`	Membership	Multi-guard Auth, Roles, and CRM.
`@gravito/satellite-commerce`	Order	Order processing and lifecycle.
`@gravito/satellite-analytics`	Analytics	Pluggable dashboard widgets & data resolvers.
`@gravito/satellite-support`	Support	Real-time WebSocket customer service.

Frontend & UI

Package	Component	Description
`@gravito/admin-shell-react`	Admin Shell	A pluggable React dashboard that auto-mounts modules.
`@gravito/support-chat-widget`	Chat Widget	A drop-in client widget for customer support.
`@gravito/prism`	Prism	Edge-optimized View Engine & Image Optimization.

🛠️ Getting Started

Installation

# In your monorepo or project
bun add @gravito/core @gravito/photon @gravito/monolith

Development

For a full-stack integrated example, check out:

🤝 Community & Support

Documentation: docs/README.md
Contributing: CONTRIBUTING.md

(繁體中文說明已整合至各模組文件與整合指南)

gravito-framework/gravito

README