TutorialStudioSpectral

Getting Started with Aexol Studio and Spectral

Artur Czemiel
3 min read
On this page5

Aexol Studio paired with the Spectral coding agent gets you from idea to production-ready code in minutes — whether you're a solo developer prototyping a SaaS or a team lead standardizing how your organization defines APIs. Here's the short path.

What Is Aexol Studio?

Aexol Studio is a browser-based IDE for the Aexol specification language — nothing to install. It combines a code editor with real-time validation for .aexol files, AI Import that turns natural language into specs, code generation into GraphQL/Prisma/TypeScript artifacts, and project and team management. The split view shows your code on the left and a live visualization of your spec on the right:

Aexol Studio IDE showing the Explorer sidebar with project files, code editor with Aexol type definitions, and Code/Refine/Visual tabs
FIG.01 Aexol Studio IDE showing the Explorer sidebar with project files, code editor with Aexol type definitions, and Code/Refine/Visual tabs

Why Spectral?

Spectral is the always-on coding agent that turns your .aexol specs into production code — backend, frontend, and tests — running on your machines:

  • Install and run spectral serve; control generation from any browser tab via the Aexol relay, no port forwarding or SSH
  • Aexol-native understanding of the grammar, type system, workflows, and how they map to real code artifacts
  • Multi-language output: TypeScript, Python, Rust, Go, and more

Pick an LLM model in the Generate panel and Spectral runs the pipeline end to end.

API Models management panel showing built-in and team models with provider configuration
FIG.02 API Models management panel showing built-in and team models with provider configuration

Setup and your first spec

Sign in at studio, complete onboarding, and you land in the editor with an empty project. Create a .aexol file and describe your domain — types, enums, workflows, agents:

type Task {
  title: String
  status: TaskStatus
  priority: Priority
  assignee: User
  dueDate: DateTime
}

workflow TaskFlow {
  initial: backlog
  backlog -> in_progress when started
  in_progress -> review when submitted
  review -> done when approved
}
✨ Edit in Studio

You get syntax highlighting, instant validation in the bottom panel, and a live visualization as you type:

Writing an Aexol specification in the Studio code editor with type definitions and syntax highlighting
FIG.03 Writing an Aexol specification in the Studio code editor with type definitions and syntax highlighting

Don't want to write it by hand? The Define tab takes plain English — paste a description of your app, pick a model, click Generate, and a complete specification appears in the editor for review. Past imports are kept at /studio/from.

Refine with AI feature in Aexol Studio showing model selection and natural language refinement instructions
FIG.04 Refine with AI feature in Aexol Studio showing model selection and natural language refinement instructions

Generate code

Open the Generate panel (⌘2), pick a target language and an LLM model, click Generate:

Studio Generate panel with AI model selection, artifact configuration, and Generate Code button
FIG.05 Studio Generate panel with AI model selection, artifact configuration, and Generate Code button

For a typical spec you'll get a GraphQL schema, Prisma models with proper relations, typed TypeScript interfaces, resolver stubs, and workflow state-machine logic — production-ready, not boilerplate.

Iterate

Review the output, refine the spec, re-generate — Spectral incorporates the changes. You can also switch models and compare results side by side at /studio/tasks. This loop is where Aexol shines: you spend your time on high-level design decisions while Spectral handles the implementation.

Next steps: Studio Guide · Language Tutorial · Spectral · Open Studio

Happy building.