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.