The Broadleaf tutorials will give you hands on experience with our key concepts and extension patterns.
The tutorials are grouped into tutorial sets. Each tutorial set can be run in any order, see the overview and goals of each set below.
This tutorial provides a Basic Customer service and shows you how to extend service and domain components. The example service is not our production ready service but instead a simplified version for tutorial purposes.
This tutorial set starts with a Spring Boot application with no Broadleaf concepts. It incrementally adds in features. It is useful as a way to better understand some of the features you’ll find in the hundreds of out of box APIs and services and as a starting point for incorporating Broadleaf advanced features like multitenancy, workflow capabilities, and rich admin experiences to your own APIs.
Broadleaf provides full source code to our clients but you should never need to modify the Broadleaf source code. Instead, we make it easy to extend and replace components as needed. These tutorials will help you understand how that works.
To work with the customization and hands on tutorials, you’ll need a few prerequisites. These are not needed for the Use APIs tutorials.
Java 8 or higher - (How do I get Java?)
Your Github account - (Don’t have one? Sign up at GitHub)
Visit the Broadleaf Tutorials Github page at https://www.github.com/BroadleafCommerce/MicroservicesTutorial
The MicroserviceTutorial project contains all of the tutorials. Each tutorial will guide you through the right steps
Start by forking the project: (https://docs.github.com/en/github/getting-started-with-github/fork-a-repo [learn more about GitHub forks^])
From the repository main screen, choose the CODE button and select to clone or download the
zip file. You can unzip or clone to any directory on your machine. In our examples, we will use the
~/tutorials/ to represent the installation directory.
You are now are ready to start a tutorial …
Where would you like to start?