Write the schema. Ship the artifact.

Transform your ideas to reality

Idea is a schema file specification and a transformation toolchain. You describe models and metadata in a .idea file, then run plugins to generate code or other artifacts. Many ideas. Many outputs.

Start here See examples Browse specs

Schema sketch

model User {
  id String @id
  name String
  email String
}

plugin "./schema-diagram.mjs" {
  output "./generated/schema.mmd"
}

Start

Getting Started

This guide takes you from an empty folder to a generated file.

Concepts

Concepts Overview

Idea is a schema language plus a transformation runtime.

How-To

Run A Schema

This guide shows the normal CLI workflow.

Reference

Specification Reference

This page describes the core `.idea` file format as implemented by the parser in this repository.

Examples

This section collects longer tutorials that show different ways you can use Idea.

Parser

Keep the schema permissive

The parser handles declarations, literals, arrays, objects, comments, and schema composition without forcing every attribute into one rigid meaning.

Transformer

Generate many outputs

Use plugins to turn one schema into interfaces, diagrams, docs, forms, API contracts, or project-specific artifacts that fit your stack.

Tooling

Author, inspect, extend

The CLI, plugin API, examples, and VS Code extension give the schema format a practical workflow instead of leaving it as a bare specification.

Transform your ideas to reality

Define your idea