The microfleet/core repository is an opinionated web and microservices toolkit written in TypeScript that provides a structured framework for building production-grade microservices. Maintained by Vitaly Aminev, it positions itself as a middle ground between usability and flexibility, enabling developers to create robust microservices within minutes by handling common infrastructure concerns while developers focus on business logic implementation.
The toolkit has been in active development since 2015 and is designed to handle hundreds of thousands of transactions per second on modest hardware through careful architectural decisions. The core philosophy emphasizes that most applications share common functionality, and the toolkit aims to provide a solid foundation that allows developers to prove startup concepts and safely roll out applications that can handle significant load.
The repository is structured around a plugin architecture with several categories of plugins. Essential plugins include a validator based on json-schema for input data validation, a logger built on bunyan for request logging, and a router that manages multi-transport request handling. The router implements a well-defined request lifecycle modeled after hapi.js, consisting of six stages: request checking, authentication, validation, permission checking, handler execution, and response formatting. Each stage includes pre and post hooks that allow developers to extend behavior at specific points in the request flow.
Transport plugins enable communication across multiple protocols. The toolkit supports AMQP transport via RabbitMQ, HTTP through hapi.js, and WebSocket connections through Socket.IO. Database connectivity is provided through plugins for Redis in both cluster and sentinel configurations using ioredis, Knex for SQL databases including PostgreSQL and MySQL, Elasticsearch, and Cassandra.
The toolkit comes with sensible default configurations that scan the src/actions directory for action handlers and enable HTTP handling on port 3000 by default. Input validation is performed automatically based on json-schema files placed in a schemas directory, with schema names corresponding to action names. The validation system provides both promise-based and synchronous APIs with support for type coercion, defaults, and property filtering.
GitGenius activity data indicates this is an actively maintained project with overlapping contributors from apollographql/apollo-client, toeverything/affine, and apollographql/apollo-server, suggesting integration with broader ecosystem projects. The repository is classified across multiple domains including microservices, service frameworks, plugin architecture, dependency injection, configuration management, logging, error handling, middleware, and modular design patterns.
The toolkit is complemented by a suite of specialized microservices built on the core framework, including user management, file distribution, payments processing, chat functionality, email delivery, SMS capabilities, social service integration, calendar management, and organization account handling. These services demonstrate the lego-like composability that the toolkit enables, allowing developers to combine services to achieve desired functionality. Installation is straightforward through npm or yarn with the package name @microfleet/core.
