JSPM

  • Created
  • Published
  • Downloads 176
  • Score
    100M100P100Q74240F
  • License MIT

CMMV (@core)

Package Exports

  • @cmmv/core
  • @cmmv/core/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@cmmv/core) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

CMMV Logo

Contract-Model-Model-View (CMMV)
A minimalistic framework for building scalable and modular applications using TypeScript contracts.

NPM Version Package License CircleCI

DocumentationReport Issue

Description

CMMV (Contract-Model-Model-View) is a minimalistic and modular framework for building scalable applications in TypeScript. Inspired by modern design patterns, CMMV uses contracts to define the entire application, from ORM entities to REST controllers and WebSocket endpoints, allowing for a highly structured and maintainable codebase.

Philosophy

CMMV aims to simplify the development process by leveraging TypeScript's powerful type system and decorators. It eliminates the need for heavy frontend frameworks by focusing on direct control over data binding and interactions, while maintaining flexibility through modular design.

Features

  • Contract-Driven Development: Use TypeScript contracts to define models, controllers, and more.
  • Modular Architecture: Compose your application using modules, making it easy to manage and scale.
  • RPC & REST Support: Integrated support for both binary RPC via WebSocket and traditional REST APIs.
  • Express Integration: Seamless integration with Express for a familiar and robust HTTP server environment.
  • Extensible: Highly customizable and easy to extend with your own modules and components.

Installation

CMMV is available as a collection of npm packages. To install the core package, use npm:

$ npm install @cmmv/core @cmmv/http @cmmv/protobuf @cmmv/ws @cmmv/view @cmmv/repository

Quick Start

Below is a simple example of how to create a new CMMV application:

import { Application } from "@cmmv/core";
import { DefaultAdapter, DefaultHTTPModule } from "@cmmv/http";
import { ProtobufModule } from "@cmmv/protobuf";
import { WSModule, WSAdapter } from "@cmmv/ws";
import { ViewModule } from "@cmmv/view";
import { RepositoryModule, Repository } from "@cmmv/repository";
import { ApplicationModule } from "./app.module";

Application.create({
    httpAdapter: DefaultAdapter,    
    wsAdapter: WSAdapter,
    modules: [
        DefaultHTTPModule,
        ProtobufModule,
        WSModule,
        ViewModule,
        RepositoryModule,
        ApplicationModule
    ],
    services: [Repository],
    contracts: [...]
});

Documentation

The complete documentation is available here.

Support

CMMV is an open-source project, and we are always looking for contributors to help improve it. If you encounter a bug or have a feature request, please open an issue on GitHub.

Stay in Touch

License

CMMV is MIT licensed.