Your First Pipeline

This guide walks you through creating a complete pipeline from scratch — a two-stage CI workflow that installs dependencies, runs tests, then builds an artifact.

1. Create the pipeline

From inside a project, click New Pipeline. Give it a name like ci. The pipeline editor opens on an empty canvas.

2. Set up the trigger

Before adding stages, configure when the pipeline should run.

Click the Trigger button in the toolbar (or the trigger node if one is shown). Select:

• Type: Push
• Branches: main, develop

This means the pipeline will fire on every push to main or develop.

3. Add a "Build" stage

Click anywhere on the empty canvas. A panel appears — select Add Stage.

Name it Build.

A stage card appears on the canvas.

4. Add a job to the Build stage

Double-click the Build stage card to enter the stage view.

Click Add Job, name it install-and-test, and set Runs on to ubuntu-latest.

5. Add steps to the job

Double-click the install-and-test job card to enter the job view.

Add your first step by clicking Add Step:

Step 1 — Checkout

• Type: git
• Operation: checkout
• Label: Checkout code

Step 2 — Install dependencies

• Type: shell_command
• Shell: bash
• Script:

  npm ci

• Label: Install dependencies

Step 3 — Run tests

• Type: test
• Framework: vitest (or jest, depending on your project)
• Command: npm test
• Label: Run tests

6. Add a "Deploy" stage

Use the breadcrumb to go back to the Pipeline view.

Add a second stage, name it Deploy.

Connect the stages: hover over the Build card, grab the handle on its right edge, and drag it to the Deploy card. An arrow appears showing the dependency — Deploy runs after Build succeeds.

7. Configure the Deploy job

Double-click into Deploy, add a job named build-artifact on ubuntu-latest.

Add one step:

• Type: build
• Tool: npm
• Command: npm run build
• Label: Build production bundle

8. Save the pipeline

Click Save in the top toolbar. Your pipeline is saved to pipel8ne's database.

9. Export to YAML

Click Export and choose your target platform (e.g. GitHub Actions). A .yml file downloads to your machine — ready to commit to your repository.

---

What you built

Trigger: push to main / develop
    │
    ▼
[Build Stage]
  └── install-and-test (ubuntu-latest)
        1. Checkout code
        2. Install dependencies
        3. Run tests
    │
    ▼ (only if Build succeeds)
[Deploy Stage]
  └── build-artifact (ubuntu-latest)
        1. Build production bundle

Next: The Visual Canvas — learn all the canvas controls and shortcuts.