Skip to content
EMB

Tutorial Overview

Welcome to the EMB tutorials! This series of hands-on guides will teach you how to use EMB effectively, starting from the basics and progressing to advanced features.

Learning Path

Section titled “Learning Path”

The tutorials are organized into four progressive sections, each using a real example monorepo from the examples/ folder:

1. Hello World - The Basics

Section titled “1. Hello World - The Basics”

Start here if you’re new to EMB. Learn the fundamentals with a minimal single-component project.

You’ll learn:

  • Installing EMB
  • Creating a minimal configuration
  • How auto-discovery works
  • Basic EMB commands

Start with Hello World →

2. Fullstack App - Tasks & Docker Compose

Section titled “2. Fullstack App - Tasks & Docker Compose”

Build on the basics with a two-component web application (API + frontend).

You’ll learn:

  • Multi-component projects
  • Environment variables and the dotenv plugin
  • Defining and running tasks
  • Docker Compose integration

Continue to Fullstack App →

3. Microservices - Dependencies & Scale

Section titled “3. Microservices - Dependencies & Scale”

Learn to manage complex projects with multiple interdependent services.

You’ll learn:

  • Shared base images
  • Component dependencies
  • Build ordering and optimization

Continue to Microservices →

4. Production Ready - Flavors & Deployment

Section titled “4. Production Ready - Flavors & Deployment”

Master environment-specific configurations for staging and production deployments.

You’ll learn:

  • Multi-stage Docker builds
  • Flavors and JSON Patch
  • Environment-specific configurations

Continue to Production Ready →

Prerequisites

Section titled “Prerequisites”

Before starting, ensure you have:

  • Node.js 20+ - Check with node --version
  • Docker - Check with docker --version
  • Docker Compose - Check with docker compose version

Example Monorepos

Section titled “Example Monorepos”

Each tutorial uses a real, working example from the repository:

ExampleComponentsFocus
examples/hello-world1Minimal setup, auto-discovery
examples/fullstack-app2Tasks, environment, docker-compose
examples/microservices4Dependencies, base images
examples/production-ready2Flavors, multi-stage builds

You can explore these examples directly in the EMB repository.

Getting Help

Section titled “Getting Help”