Skip to content

Tutorials — Overview

The Naftiko Fleet tutorials are organized into four learning tracks, each focused on a distinct problem domain. They are independent — you do not need to complete them in order — but they build on the same example, a maritime shipping company called Shipyard, so the data shapes will look familiar.

Two Shipyards

The fictional maritime company in these tutorials is also called Shipyard — a deliberate pun. The Naftiko Fleet component you're reading these docs on is also called Shipyard. Context will make clear which is which: the fictional one ships cargo, the real one ships docs.

Track What you will build Time
Track 1 — Context Engineering A capability that goes from mock to live MCP tools talking to a real Maritime Registry API. 30–45 min
Track 2 — API Reusability Skill groups, Aggregates with ref:, and a parallel REST adapter — one capability, three doors. 30 min
Track 3 — API Orchestration A multi-source Fleet Manifest with orchestrated steps, lookup joins, and shared consumes. 30 min
Track 4 — Platform Operations Linting in CI, observability via the Control Port, multi-environment binds. 20 min

Run every step in your browser — no install required

Every numbered step in these tutorials has a matching page in the Shipyard Playground where you can hit Serve and call a live endpoint instantly:

Each step's Run it section links directly to its Playground page.

Prerequisites for all tracks

  • Ikanos running (Docker or native CLI)
  • A YAML-aware editor — we strongly recommend Crafter, the Naftiko VS Code extension
  • An MCP client for testing — the MCP Inspector is the fastest to set up

All capability YAML files referenced in the tutorials are available in the Ikanos tutorial folder.

If this is your first time, follow this order:

  1. Installation — get a local Ikanos runtime ready for the tutorial files.
  2. Track 1, Steps 1–3 — the contract-first workflow.
  3. Pick one of Tracks 2, 3, or 4 based on what you want to build next.