This tutorial walks you through building your first Trellis service step by step. By the end, you will have a working orders-service that connects to the network, stores data, handles requests, listens to events, publishes its own events, and exposes a feed.

Before diving in, we recommend skimming Trellis Concepts to understand how contracts, RPCs, and NATS work together.

Each implementation section uses language selectors for TypeScript and Rust. The service contract and runtime lifecycle are the same in both languages; Rust uses generated SDK artifacts plus the service runtime facade during service compilation.

What you need

• A running Trellis environment (see Starting Trellis)
• Deno or Node.js for the TypeScript path
• Rust stable for the Rust path
• The trellis CLI installed
• trellis-generate available for Rust contract artifact generation

Tutorial path

1. Set up the project
2. Your first contract
3. The service entry point
4. Adding a database
5. Writing our first RPC
6. Retrieving an order with service errors
7. Listening to the outside world
8. Publishing your own events
9. Use a feed for filtered live views
10. Handle graceful shutdown
11. Prepare SDKs and contract artifacts
12. Declare optional dependencies
13. Use the development loop

Start with project setup.