Todo App with SolidX

Build a working Todo app with SolidX, PostgreSQL, Swagger, and the SolidX MCP workflow.

Tutorial Overview

This tutorial walks you through the SolidX flow from zero to a working Todo app in a few minutes.

This is a fast, beginner-first walkthrough. You start with PostgreSQL in Docker, scaffold a fresh SolidX app, install the SolidX MCP connection into your agent, start the app locally, and generate a working Todo module with two prompts.

SolidX Concepts Used Here

A module groups related functionality. In this tutorial, todo-management is the module for the Todo feature.
A model describes the data the app stores. The todoItem model defines each Todo and its fields, such as title and status.
Metadata is the configuration SolidX uses to generate the initial API and admin UI from your module and model.
MCP connects your AI agent to the running SolidX app, allowing the agent to use SolidX tools while creating the module and model.

By the end, you will have:

Started PostgreSQL in Docker
Scaffolded a SolidX app
Connected an MCP-capable agent to SolidX
Generated a working todo-management module
Verified the generated CRUD API in Swagger
Identified a few concrete follow-up experiments to extend the app

This tutorial is beginner-friendly. It is meant to show the fastest path to a real generated app, built using SolidX.

Tutorial Flow

Project Setup

Start PostgreSQL in Docker, scaffold the SolidX project, install the MCP connection into your agent, then bring up the admin UI and API locally.

Build the Todo App

Use two prompts to generate the Todo module, then verify the result in the UI and Swagger.

Next Steps

Extend the generated Todo app with a few practical follow-up exercises.

At a Glance

Time to Finish

About 5 to 10 minutes if your local Docker, Node.js, and npm setup is already working.

What You Will Generate

One todo-management module with a todoItem model, generated admin views, API routes, and menu wiring.

What You Will Use

PostgreSQL, SolidX CLI, Swagger, and an MCP-capable client connected through the SolidX MCP server.

Where This Ends

With a working generated module plus a short list of next experiments you can try immediately.