identity-hub

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.

---

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

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

Example Configuration

```typescript

// 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

]

};

```

---

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. |

---

Installation

```bash

# In your monorepo or project

bun add @gravito/core @gravito/photon @gravito/monolith

```

Development

For a full-stack integrated example, check out:

• [Commerce Fullstack Example](./examples/commerce-fullstack)
• [1.0 Integration Guide](./docs/GUIDE_1.0_INTEGRATION.md)

---

• Documentation: [docs/README.md](./docs/README.md)
• Contributing: [CONTRIBUTING.md](./CONTRIBUTING.md)
• License: MIT © Carl Lee

---

(繁體中文說明已整合至各模組文件與 [整合指南](./docs/GUIDE_1.0_INTEGRATION.md))