Polylith is a software architecture that applies functional thinking at the system scale. It helps us build simple, maintainable, testable, and scalable backend systems.
Welcome to Polylith!
Polylith is a software architecture that decouples our code into reusable building blocks in a way that allows us to work with them from one place and put them together into various deployable artifacts like services.
There are several ways of learning Polylith:
Try it out yourself
To learn how to build your first Polylith system, head over to the poly tool documentation where you can install it and create a workspace and follow the examples using the powerful language Clojure.
If you prefer reading the documentation, then you're already in exactly the right place! - just keep reading!
Polylith - what is Polylith?
Polylith in a nutshell - walkthrough of the building blocks of Polylith.
Workspace - were we put everything.
Component - our composable building block (brick).
Base - building block (brick) that exposes a public API
Project - deployable artifact made of a set of bricks
Development project - the place where we work with all our bricks
Bring it all together - a short example
Simplicity - how Polylith simplifies the design
poly tool - overview of the poly tool
Current architectures - a walk through of common architectures
Advantages of Polylith - how Polylith differ from other architectures
Transitioning to Polylith - step by step guide on how to transition to Polylith
Production systems - list of companies using Polylith in production
Why the name "Polylith"?
FAQ - Frequently Asked Questions
Who made this?
What is Polylith?
Polylith is a software architecture that solves some of the fundamental challenges in building backend systems. Those challenges are:
It's difficult to share our code across teams and services
We lack a shared language for communicating architectural concepts
As our codebases grow, they tend to become a complex mess that is hard to change and test
We try to mimic our complex production environments in our development environment
Our systems take too long to test, build, and deploy
Polylith addresses these challenges by introducing simple, composable, LEGO-like bricks, which can easily be shared across teams and services. The choice of bricks determines what each artifact does and how it's exposed.
To make the development experience even more delightful, we've also built a tool which gives instant creation of the various building blocks, incremental tests (only test the code that's impacted by the last changes), and project visualization.
What isn't Polylith?
Polylith isn't a framework and does not come with ready to use functionality.
Polylith isn't a library.
Polylith isn't a tool (but has tooling support for Clojure).
What programming languages are Polylith for?
Polylith is language agnostic, and it should be possible to use it in almost any programming language. We in the Polylith team have only used it with the functional language Clojure so far, but there is nothing stopping someone from using it in a procedural language like C, or an object oriented language like Java. Even without tooling support, you will get most of the benefits.