Repository files navigation

Flamingock bringsChange-as-Code (CaC) to your entire stack.
It appliesversioned, auditable changes to the external systems your application depends on — such as schemas, message brokers, databases, APIs, cloud services, and any other external system your application needs.

Unlike infrastructure-as-code tools, Flamingock runsinside your application (or via theCLI).
It ensures these systems evolvesafely, consistently, and in sync with your code at runtime.

Flamingock focuses onapplication-level changes that your code requires to run safely:

• Database schemas and reference data
• Message queues and schemas
• APIs and configuration values
• Cloud service resources directly tied to your application
• Configuration changes (feature flags, secrets, runtime values)

Flamingock isnot an infrastructure-as-code tool. It does not provision servers, clusters, or networks — those belong in Terraform, Pulumi, or similar. Instead, Flamingockcomplements them by handling the runtime changes your application depends on.

For more information about Flamingock for Java library, please visit the main repositoryhere.

This repository is structured asIndividual Gradle Projects, with each project demonstrating Flamingock'sintegration with different frameworks, technologies, and use cases. Explore the examples to find the one that matchesyour needs!

Each example is prepared to run from its own test with all infrastructure (databases, mocked servers, etc.) needed.But you can also run it with your own infrastructure.

🚀New examples will be added regularly! Stay tuned for updates as we expand the repository to cover even moresystems and frameworks.

1. Clone this repository:

   git clone https://github.com/flamingock/flamingock-java-examples.gitcd flamingock-java-examples

2. Navigate to the example you want to explore:

cd inventory-orders-service

3. Run example

3.a. Run the project test using Gradle

./gradlewtest

3.b. Run the project using Gradle and your own infrastructure

./gradlew run

4. Follow the instructions in the specific project's README for further details.

We welcome contributions! If you have an idea for a new example or improvement to an existing one, feel free to submit apull request. Check out ourCONTRIBUTING.md for guidelines.

⭐ Star theFlamingock repository to show your support!

🐞 Report issues or suggest features in theFlamingock issue tracker.

💬 Join the discussion in theFlamingock community.

This repository is licensed under theApache License 2.0.

Let us know what you think or where you’d like to see Flamingock used next.