Getting started

Install the SPLENT development environment in under 5 minutes.

---

Table of contents

1. System requirements
2. Create the workspace
3. Clone repositories
4. Start Docker
5. Next steps

---

System requirements

SPLENT runs natively on Linux and macOS.

If you are using Windows, you must work inside WSL (Windows Subsystem for Linux). All commands in this guide must be executed inside the Linux terminal provided by WSL, not in PowerShell.

Before continuing, ensure that the following tools are installed:

• Git
• Docker
• SSH configured with GitHub
• GNU Make

On Windows, also ensure that:

• WSL is installed
• Docker Desktop is integrated with WSL
• Git is configured

See the detailed Windows setup guide: Windows development environment (WSL + Docker + Git)

---

Create the workspace

SPLENT is not a single repository — it is an ecosystem. All components live in a single root directory called the workspace:

mkdir splent_workspace
cd splent_workspace

---

Clone repositories

git clone https://github.com/diverso-lab/splent_framework.git
git clone https://github.com/diverso-lab/splent_cli.git
git clone https://github.com/splent-io/splent_catalog.git

If you have SSH access, clone via SSH instead:

git clone git@github.com:diverso-lab/splent_framework.git
git clone git@github.com:diverso-lab/splent_cli.git
git clone git@github.com:splent-io/splent_catalog.git

Your workspace now looks like:

splent_workspace/
  splent_framework/       # Runtime core
  splent_cli/             # Command-line interface
  splent_catalog/         # SPL definitions (UVL feature models)

---

Start Docker

cd splent_cli
make setup

This builds Docker containers and drops you into the CLI shell:

(detached) /workspace$

You are now inside the SPLENT environment. Every command from this point runs inside this container.

---

Next steps

You’re ready. Head to the Tutorials to create your first product.