freeze-static
π―Skillfrom gravito-framework/gravito
|Freezes and optimizes static assets during build time, ensuring consistent and performant asset delivery for web applications.
Installation
npx skills add https://github.com/gravito-framework/gravito --skill freeze-staticSkill Details
Overview
# 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
```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
]
};
```
---
π¦ 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
```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)
---
π€ Community & Support
- Documentation: [docs/README.md](./docs/README.md)
- Contributing: [CONTRIBUTING.md](./CONTRIBUTING.md)
- License: MIT Β© Carl Lee
---
(ηΉι«δΈζθͺͺζε·²ζ΄εθ³ε樑η΅ζδ»Άθ [ζ΄εζε](./docs/GUIDE_1.0_INTEGRATION.md))
More from this repository10
Manages content creation, storage, versioning, and rendering for dynamic web pages and blog-like sections within e-commerce websites using a modular, configuration-driven approach.
Generates comprehensive TypeScript JSDoc comments by analyzing code structure, providing intelligent type annotations, parameter descriptions, and documentation best practices.
Generates a standardized, configurable e-commerce system architecture with predefined modules, configurations, and best practices for rapid marketplace development.
atlas-expert skill from gravito-framework/gravito
Manages distributed task queues with high-throughput processing and resilient message handling across microservices in the Gravito framework's event-driven architecture.
Helps developers model complex domain logic by generating DDD-compliant TypeScript code structures, aggregates, and bounded context definitions based on natural language descriptions.
Manages operational workflows, deployment configurations, and infrastructure orchestration for Gravito Framework projects through a centralized command-line interface.
clean-architect skill from gravito-framework/gravito
Translates and adapts content across multiple languages and locales for Gravito Framework's e-commerce modules, ensuring linguistic consistency and cultural appropriateness.
Manages database schema migrations, providing version control, automated schema updates, and rollback capabilities for Gravito's Atlas ORM.