Specmatic in Action: Sample Projects

• Sample Projects
  • Overview
    • Sample Application Architecture
    • Getting Started
    • Learning path
  • In-Depth Implementations
    • OpenAPI
    • Authentication and Authorization
    • gRPC
    • GraphQL
    • Kafka
    • Google PubSub
    • JMS
    • JDBC
    • Redis
  • Need Help?
  • Contributing

Overview

Specmatic unlocks a new way to approach microservices by aligning contracts and code, making your systems reliable and resilient. Our sample projects showcase real-world implementations across various technologies and communication protocols. This is your playground to experience Specmatic.

Sample Application Architecture

Each sample project is designed around a familiar microservices setup, giving you the clarity and confidence to integrate Specmatic seamlessly into your stack.

The architecture consists of three core components:

• Frontend Application – Where the user interacts.
• BFF (Backend For Frontend) – A mediator between the frontend and backend services.
• Backend Service – The system’s engine, processing and providing data.

Getting Started

1. Choose a sample project that matches your tech stack
2. Clone the repository and follow the README instructions
3. Explore the contract tests and implementation details
4. Run the examples locally to see Specmatic in action

Learning Path

• Start with the OpenAPI examples if you’re new to Specmatic
• Progress to more complex implementations like OAuth or event-driven patterns
• Experiment with different language implementations of the same architecture

Let’s dive deeper!

---

In-Depth Implementations

OpenAPI

Let’s discover how Specmatic works across different layers of an app, with help of following sample projects.

• Frontend:
  • React and NodeJS
• BFF:
  • Kotlin (SpringBoot)
  • NodeJS (Express)
  • Python (Flask) and Sanic
  • Go (Gin)
  • .NET core (C#)
• Backend:
  • Kotlin (SpringBoot)
  • Python (Flask)
  • NodeJS (Express)

---

Authentication and Authorization

Take control of secure user access with our OAuth samples, integrating authentication into your apps.

• OAuth:
  • Kotlin (SpringBoot)

---

gRPC

Supercharge your microservices with gRPC. Get started with these samples and see how Specmatic fits in.

• BFF:
  • Kotlin (SpringBoot)
  • Go (Gin)
• Backend:
  • Kotlin (SpringBoot)

---

GraphQL

GraphQL opens a world of flexible queries—explore how Specmatic bridges contracts and GraphQL endpoints.

• Frontend:
  • React and NodeJS
• BFF:
  • Kotlin (SpringBoot)

---

Kafka

Kafka brings event-driven architecture to life. Discover Specmatic’s power in managing Kafka interactions.

• BFF:
  • Kotlin (SpringBoot)
  • NodeJS (Express)
• Request-Reply Pattern:
  • Kotlin (SpringBoot)

---

Google PubSub

Jump into event-driven architectures with Google PubSub, powered by Specmatic.

• Backend:
  • Kotlin (SpringBoot)

---

JMS

Embrace the power of Java Messaging Service (JMS) with this Specmatic-integrated sample.

• BFF:
  • Kotlin (SpringBoot)

---

JDBC

Unlock data from databases using JDBC, and see how Specmatic supports seamless contract testing.

• BFF:
  • Kotlin (SpringBoot)

---

Redis

Boost your app’s performance with Redis caching, fully integrated with Specmatic.

• BFF:
  • Kotlin (SpringBoot)

By exploring these projects, you’ll gain hands-on experience in integrating Specmatic with a variety of technologies, giving you the power to build smarter and more resilient systems. Ready to level up? Jump in and start experimenting!

---

Bringing It All Together

By exploring these projects, you’ll gain hands-on experience in integrating Specmatic with a variety of technologies, giving you the power to build smarter and more resilient systems.

Need Help?

• Join our community discussions for discussions and support
• Report bugs or suggest improvements in our GitHub repository
• Reach out directly—we’re here to help!

Contributing

We welcome contributions! If you’ve built something interesting with Specmatic:

• Submit a pull request to add your example
• Share your implementation of these samples in different frameworks
• Help us improve documentation and examples

Ready to transform how you build and test microservices? Pick a sample project and start your Specmatic journey today!