brease is an open-source monorepo that provides a robust and extensible business rules engine for various applications. It offers a comprehensive API backend server written in Go, along with TypeScript libraries for core functionality and integrations with popular front-end frameworks.
-
brease Server: The
api
folder contains a powerful and efficient backend server implemented in Go. It serves as the backbone for the entire business rules engine, offering high performance and scalability. -
@brease/core: This TypeScript library, located in the
packages/core
directory, provides framework-agnostic basic functionality. It includes essential utilities and helpers to support the implementation of business rules within your application. -
@brease/react: The
packages/react
directory contains the@brease/react
TypeScript library, which offers a React provider and a collection of simple React hooks. These components enable seamless integration of the brease business rules engine with your React applications. -
@brease/vue: Located in the
packages/vue
directory, the@brease/vue
package provides Vue 3 composables for easy integration of the brease business rules engine into your Vue applications. It simplifies the process of incorporating dynamic business rules and logic into your Vue components.
To use brease in your project, follow these steps:
-
Clone the repository:
git clone https://github.com/dotindustries/brease.git
-
Install dependencies:
cd brease pnpm install
-
Build the Go API backend server:
cd apps/api go build
-
Start the API server:
./api
-
Install the desired TypeScript libraries (e.g., @brease/core, @brease/react, or @brease/vue) in your project:
npm install @brease/core
or
npm install @brease/react
or
npm install @brease/vue
For more detailed instructions, please refer to the individual package directories.
For comprehensive documentation on how to use the brease business rules engine, refer to the official documentation. It provides detailed explanations, tutorials, and examples to help you integrate and leverage the engine's features effectively.
The API docs provide an overview of the current endpoints and changelog of the OpenAPI specification.
The gRPC API docs provide an overview of the current endpoints and changelog of the OpenAPI specification.
The gRPC assets provides access to precompiled gRPC assets and packages.
The examples
directory contains several demo applications showcasing the usage of brease with different front-end frameworks. Explore these examples to gain a better understanding of how to implement the business rules engine within your own projects.
We welcome contributions from the community to enhance and expand the functionality of brease. If you would like to contribute, please review our contribution guidelines for instructions on how to get started.
brease is licensed under the MIT License.
If you have any questions, suggestions, or feedback, feel free to reach out to us at dev@dot.industries.
We are excited to announce that we are actively developing a cloud-hosted version of brease. This version will provide a scalable and managed environment for running your business rules and logic.
-
Scalability: Seamlessly scale your business rules engine based on your application's needs. Handle large volumes of rules and requests with ease.
-
Reliability: Benefit from a robust infrastructure that ensures high availability and minimal downtime for your business rules engine.
-
Ease of Use: Enjoy a user-friendly interface and simplified management process, allowing you to focus on building and managing your rules without worrying about infrastructure or updates.
Stay tuned for updates as we finalize the development and launch of the cloud-hosted version. We are committed to delivering a powerful and efficient solution for businesses of all sizes.
To receive the latest news and updates about the cloud-hosted version of Brease, sign up for our beta program here. We'll keep you informed about the release date, changes and other important announcements.
We value your input and would love to hear your thoughts on the cloud-hosted version. If you have any specific features or requirements you'd like to see implemented, or if you have any questions or suggestions, please reach out to us at dev@dot.industries.
We appreciate your support and look forward to providing you with an exceptional cloud-hosted experience for your business.
By contributing to this project, you agree to abide by the code of conduct. Let's build a vibrant and inclusive community together!