Aexol Studio Guide

Aexol Studio is a browser-based IDE for writing Aexol specifications, generating code with AI, and managing projects — no installation required.

→ Open Aexol Studio

Overview

Studio gives you everything you need to go from idea to working code, right in your browser:

• Editor — Write and validate Aexol specs with syntax highlighting
• AI Import — Convert natural language into Aexol DSL
• Code Generation — Generate production code from specifications
• Projects — Organize your work into projects
• Teams — Collaborate with your team
• Billing — Manage subscriptions and usage

Sign in at /studio to get started. First-time users are guided through a quick onboarding flow.

Editor

The editor is the main page you land on at /studio. It uses a split-view layout: a code editor on the left and a visualization panel on the right, always visible together.

Left Sidebar Panels

The left sidebar has three panels, each accessible via keyboard shortcut:

Key Features

• Syntax highlighting for .aexol files
• Real-time validation — errors and warnings appear as you type
• Shareable URLs — share your specs via pako-compressed URLs
• Command palette — keyboard-first workflow for power users
• Status bar — file info and editor state at a glance
• Bottom panel — view output, problems, and validation results

Tip: Use the command palette for quick access to editor actions without leaving the keyboard.

AI Import

The AI Import feature (available via the Define tab at /studio?tab=define) converts natural language or requirements text into Aexol DSL.

How It Works

1. Navigate to the Define tab in the editor
2. Paste your description or requirements in plain text
3. Select an AI model from the dropdown
4. Click Generate to produce an Aexol specification

The generated spec appears in the editor, where you can refine it further.

Import History

All your previous AI imports are saved and accessible at /studio/from. You can revisit and re-use any past import as a starting point.

Tip: Be specific in your descriptions. Instead of "a todo app", try "a task management system with priorities, due dates, assignees, and a Kanban board workflow with columns: Backlog, In Progress, Review, Done".

Code Generation

The Generate panel (⌘2) lets you generate production code directly from your Aexol specifications.

Workflow

1. Open the Generate panel from the left sidebar (or press ⌘2)
2. Select your target language or framework
3. Choose an AI model for generation
4. Click Generate to start
5. View the generated files in the output panel
6. Download or copy the results

Task History

All generation tasks are logged and available at /studio/tasks. You can:

• Review past generation results
• Re-run previous tasks with updated specs
• Compare outputs across different AI models

Tip: Try generating the same spec with different AI models to compare output quality and style.

Projects

Manage your work at /studio/projects. Each project is a self-contained workspace with its own set of .aexol files.

Project Features

• Create new projects with a name and description
• Browse all your projects on the project cards view
• Quick switch between projects using the header project selector
• Project cards display:
  • Project name and description
  • File count
  • Last modified date

Project Organization

Keep your specs organized by domain or service:

my-saas-app/
  ├── auth.aexol          # Authentication & users
  ├── billing.aexol       # Subscription & payments
  ├── core.aexol          # Core business logic
  └── notifications.aexol # Notification system

Teams

Collaborate with others at /studio/teams. Teams provide shared access to projects and centralized management.

Team Features

• Invite members by email
• Role management with three levels:
  • Admin — Full control over team settings, billing, and members
  • Moderator — Manage projects and members
  • Member — Access shared projects and generate code
• Usage tracking — Monitor AI token usage and generation activity across the team
• Shared projects — All team members can access team projects
• API key management — Generate and manage API keys for programmatic team access

Tip: Create separate teams for different departments or clients to keep projects and billing isolated.

Billing

Manage subscriptions and usage at /studio/billing.

Plans

Billing Features

• Token usage tracking — See how many AI tokens you've consumed
• Quota management — Monitor remaining capacity
• Stripe-powered checkout — Secure payment processing
• Billing portal — Manage payment methods, view invoices, and update plans
• Per-team billing — Each team has its own subscription and usage tracking

Profile

Manage your account at /studio/profile.

• User profile settings — Update your display name and preferences
• Default model preferences — Set your preferred AI model for generation and import tasks

Onboarding

When you first sign in to Studio, a guided onboarding flow walks you through setup:

1. Set up your team — Choose a team name
2. Create your first project — Give it a name and optional description

After onboarding completes, you land directly in the editor, ready to write your first specification.

Tip: You can create additional teams and projects later from their respective pages.

Keyboard Shortcuts

Getting Started Step by Step

Here's the fastest path from zero to generated code:

1. Sign Up & Log In

Go to Aexol Studio and create an account or sign in.

2. Complete Onboarding

Set your team name and create your first project. This takes about 30 seconds.

3. Write or Import a Specification

You have two options:

Option A — Write directly:

type Task {
  title: String
  description: String
  status: TaskStatus
}

enum TaskStatus {
  todo
  in_progress
  done
}

workflow TaskFlow {
  initial: todo
  todo -> in_progress when started
  in_progress -> done when completed
  in_progress -> todo when reverted
}

agent TaskManager {
  "create tasks"
  "assign tasks"
  "update status"
}

Option B — Import from natural language:

Switch to the Define tab, paste a description like:

"A project management tool with tasks, sprints, and team members. Tasks can be in Backlog, In Progress, Review, or Done states."

Select a model and click Generate.

4. Validate Your Spec

The editor validates in real-time. Check the bottom panel for any errors or warnings and fix them before proceeding.

5. Generate Code

Open the Generate panel (⌘2), select your target language and AI model, then click Generate. Watch as production-ready code is created from your specification.

6. Download Your Code

Once generation completes, download the generated files or copy them directly to your project.

Studio Pages Reference

Ready to try it? → Open Aexol Studio and start building.