WAIL (Web AI Language)

A declarative markup language for AI-powered web interactions.

Write your application in WAIL and run it with WAIL Engine in any browser.

What is WAIL?

WAIL is a simple, declarative language that lets anyone create AI-powered web experiences without writing JavaScript. Define your data, specify AI behaviors, and build interactive applications—all in readable markup.

METADATA
title: City Quiz
description: Test your geography knowledge

AI-GENERATED
ai-evaluation: evaluate user facts for accuracy
ai-grade: assign grade A-F with explanation

VIEWS
<view name="input">
# What do you know about {city}?
<form>
  <textarea name="facts" placeholder="Enter three facts..."></textarea>
</form>
</view>

<view name="results">
## Your Grade: {ai-grade}
{ai-evaluation}
</view>

DATA
cities:
- Tokyo
- Paris
- New York

Quick Start

1. Download wail.engine.html
2. Edit the <script type="text/wail"> section
3. Open in any browser
4. That’s it!

Features

• Declarative - Describe what you want, not how to build it
• Markdown-First - Write naturally, add interactivity easily
• AI-Native - LLM integration built into the language
• Single File - No build process, runs anywhere
• Auto-Save - Drafts persist automatically via localStorage
• Database - Optional permanent storage with IndexedDB

WAIL Engine

WAIL Engine is the reference JavaScript implementation that parses WAIL syntax and creates interactive AI-powered applications.

Requirements:

• Modern browser
• Free API key from Groq

Language Structure

• METADATA - Title, author, description
• AI-GENERATED - Define AI behaviors and outputs
• VIEWS - UI screens with forms and content
• DATA - Static data like lists and options

Variables use {variable} syntax and interpolate automatically.

Use Cases

• Educational quizzes with AI grading
• Interactive surveys with intelligent analysis
• Smart form wizards
• AI feature prototyping
• Teaching AI without code

Architecture

WAIL Engine uses a three-layer data approach:

• Memory - Active session state (formData, aiData)
• localStorage - Auto-saved drafts (survives refresh)
• IndexedDB - Permanent records (exportable)

Roadmap

• WAIL 1.0 specification
• Multi-provider AI support
• Visual editor
• Template library
• VS Code extension

Contributing

WAIL is in early development. We welcome feedback, examples, and contributions.

License

MIT License

---

🐋 WAIL - The language of AI interactions.​​​​​​​​​​​​​​​​