Tutorials · Vidocq

These tutorials walk you through building real applications with Vidocq, one step at a time. Each one is self-contained, starts from an empty directory (or from the previous tutorial), and every command has been run against the released artifacts.

Tutorial	You will build
Your first Vidocq application	A REST service scaffolded with the CLI: install, create, write a resource, run it, use dev mode, and package it for production. Start here.
REST + database	The same application extended with persistence: a Jakarta Data repository (Mansart) over a pooled datasource, transactions included — and a look at named datasources and PostgreSQL Dev Services.

Tutorial

You will build

Your first Vidocq application

A REST service scaffolded with the CLI: install, create, write a resource, run it, use dev mode, and package it for production. Start here.

REST + database

The same application extended with persistence: a Jakarta Data repository (Mansart) over a pooled datasource, transactions included — and a look at named datasources and PostgreSQL Dev Services.

Tutorials are learning-oriented: they take you somewhere, in order. If you are looking for the reference material instead, each component of the sidebar has its own documentation — start with the Vidocq Runtime pages.