'Workspace' is the root folder in a Polylith project. It's where we work with our building blocks and assemble our services.

Our example workspace is from the Polylith RealWorld example app.

Let's extend the building block metaphor into a desk metaphor. We can think of a workspace as a desk: a place to work with our building blocks. It has "drawers" to keep the blocks, "shelves" to assemble our services, and a "work surface" of environments for development.

In the initial release of Polylith services were called systems, and systems were called ecosystems. The documentation has been updated to reflect the new names, but the images still reflect the original naming.

A workspace is like a desk with drawers, shelves and a work surface
The "drawers" are the folders where we keep the bases, components and interfaces
The "work surface" is the folder where we keep our development environment(s)
The "shelves" are the folder where we configure and store our services

Let's take a look inside the first "drawer", where we keep all the bases.