SID

Tutorials

Step-by-step guides for common tasks in the SID Platform

Tutorial 1: Creating Your First Application

  1. Sign up for an account at sidai.live
  2. Get your API key from the API Portal
  3. Create a new ADL file describing your application
  4. Use the compile_adl tool to generate your application
  5. Deploy the generated code

Tutorial 2: Using the Model Context Protocol (MCP)

  1. Obtain your MCP API key
  2. Connect to the MCP endpoint at https://api.sidislab.com/mcp
  3. Use the recall_memory tool to get relevant patterns
  4. Use the get_tool_cookbook tool to plan your approach
  5. Write your ADL specification
  6. Validate with validate_adl
  7. Compile with compile_adl
  8. Monitor progress with task_get
  9. Retrieve results with task_result

Compiler Targets

The compiler validates the declared target kinds through the live gateway (18 of 22 kind probes pass validate_adl; the 4 un-emitted backends fail loudly at validation, never silently emitting the wrong server). Emission is build-verified end to end: axum, express, and fastapi backends compile and serve real API round-trips, and the react-app, vue-app, svelte-app, solid-app, and leptos-app frontends build into apps that route to their CRUD pages.

Backends (axum + express + fastapi EMIT; actix/hono/fastify/go-gin reject)

axum · express · fastapi · binary

Recognized but rejected at validate_adl until emitters land: actix · hono · fastify · go-gin

Frontends (react/vue/svelte/solid/leptos build today)

react-app · vue-app · svelte-app · solid-app · leptos-app

nextjs-app and drogon-static validate; emission parity tracked in the DIS bug list

Databases (postgresql + sqlite emit correct SQL today)

postgresql · sqlite

clickhouse · mysql · mongodb · redis · none validate; query placeholders still target postgres/sqlite

The engine also emits real C++ for its system/config domains (config types, storage rows, internal tooling) — those are not application backends. Python is a first-class backend via backend: "fastapi".

Tutorial 3: Deploying Generated Applications

  1. After code generation, navigate to the generated directory
  2. For Docker deployment: run docker-compose up -d
  3. For direct deployment: build and run the backend binary
  4. Configure environment variables as needed
  5. Access your application at the configured ports