Firefly Framework

 _____.__ _____.__ _/ ____\__|______ _____/ ____\ | ___.__. \ __\| \_ __ \_/ __ \ __\| |< | | | | | || | \/\ ___/| | | |_\___ | |__| |__||__| \___ >__| |____/ ____| \/ \/ _____ __ _/ ____\___________ _____ ______ _ _____________| | __
\ __\\_ __ \__ \ / \_/ __ \ \/ \/ / _ \_ __ \ |/ /
| | | | \// __ \| Y Y \ ___/\ ( <_> ) | \/ < |__| |__| (____ /__|_| /\___ >\/\_/ \____/|__| |__|_ \
\/ \/ \/ \/
--------------------------> Enterprise software made easy <-

Enterprise-grade reactive framework with distributed transactions, event-driven patterns, and battle-tested reliability.

Firefly Framework is a modular Spring Boot superset spanning 40 repositories and providing production-ready building blocks for mission-critical distributed systems. Built on Spring WebFlux and Project Reactor, every module ships as an independent artifact and follows established enterprise patterns -- CQRS, Event Sourcing, Saga/TCC, and Event-Driven Architecture.

• Unified Orchestration -- Workflow, Saga, and TCC patterns in a single reactive engine with shared persistence, observability, and event sourcing
• Event-Driven Architecture -- Kafka and RabbitMQ with dead-letter queues and Protobuf serialization
• CQRS and Event Sourcing -- Command/query separation with reactive event store and projections
• Reactive from the ground up -- Spring WebFlux, R2DBC, and Project Reactor throughout
• Enterprise integrations -- ECM, identity providers, notifications, and caching
• Java 25 (default, Java 21+ compatible) / Spring Boot 3.5.10 / Spring Cloud 2025

The fastest way to get started is with the Firefly CLI (flywork):

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/fireflyframework/fireflyframework-cli/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/fireflyframework/fireflyframework-cli/main/install.ps1 | iex

Then bootstrap the entire framework into your local environment:

flywork setup # clones all repos in dependency order and installs to ~/.m2
flywork create core # scaffold a new microservice from a built-in archetype
flywork doctor # verify your environment (Java, Maven, Git, etc.)

Four project archetypes are available: core, domain, application, and library. See the CLI documentation for full details.

Firefly Framework artifacts are published to GitHub Packages. You need to configure Maven with a GitHub Personal Access Token before adding dependencies. See the Getting Started Guide for step-by-step instructions.

Once configured, inherit the parent POM:

<parent>
<groupId>org.fireflyframework</groupId>
<artifactId>fireflyframework-parent</artifactId>
<version>26.02.07</version>
<relativePath/>
</parent>

Then add the modules you need -- no version tags required:

<dependencies>
<dependency>
<groupId>org.fireflyframework</groupId>
<artifactId>fireflyframework-web</artifactId>
</dependency>
<dependency>
<groupId>org.fireflyframework</groupId>
<artifactId>fireflyframework-r2dbc</artifactId>
</dependency>
</dependencies>

See the Module Catalog for the full list of available modules.

Firefly Framework also provides fireflyframework-genai -- a production-grade GenAI metaframework built on Pydantic AI. It extends Pydantic AI with six composable layers covering agents, tools, reasoning patterns (ReAct, CoT, Plan-and-Execute, and more), DAG pipeline orchestration, observability, and REST / message-queue exposure -- so you can build, validate, and deploy intelligent agents without coupling domain logic to infrastructure.

curl -fsSL https://raw.githubusercontent.com/fireflyframework/fireflyframework-genai/main/install.sh | bash

• Getting Started Guide -- Configure GitHub Packages, create your first project, and start building
• Module Catalog -- Complete reference of all framework modules
• CI/CD Configuration Guide -- Shared workflows, release process, and troubleshooting

Apache License 2.0 -- Copyright 2024-2026 Firefly Software Foundation.

See the CI Status Dashboard for live build status across all 40 repositories.