JSPM

🎼 Devalang, by Devaloop Labs

🎶 Compose music with code — simple, structured, sonic.

Devalang is a tiny domain-specific language (DSL) for music makers, sound designers, and audio hackers. Compose loops, control samples, and automate parameters — all in clean, readable text.

🦊 Whether you're building a track, shaping textures, or performing live, Devalang helps you think in rhythms. It’s designed to be simple, expressive, and fast — because your ideas shouldn’t wait.

From studio sketches to live sets, Devalang gives you rhythmic control — with the elegance of code.

🚧 v0.0.1-alpha.1 Notice 🚧

Devalang is still in early development. This version does not yet include sound rendering.

You can parse code, generate the AST, and validate syntax — all essential building blocks for the upcoming audio engine.

Currently, only .kick is included as a built-in trigger. Custom instruments can be defined with @load, allowing any sound sample to be triggered with the same syntax.

Currently, Devalang CLI is only available for Windows.
Linux and macOS binaries will be added in future releases via cross-platform builds.

🚀 Features

• 🧩 Module system for importing and exporting variables between files (@import, @export)
• 📜 Structured AST generation for debugging and future compilation
• 🔢 Basic data types: strings, numbers, booleans, maps, arrays
• ⏱️ bpm assignment for setting tempo
• 🧱 bank declaration to define the instrument set
• 🔁 Looping system with fixed repetitions (loop 4:)
• 🧪 Instruction calls with parameters (e.g. .kick auto {reverb:10, decay:20}) for testing pattern syntax
• 📄 let assignments for storing reusable values
• 🔄 @load assignment to load a sample (.mp3, .wav) to use it as a value
• 🛠️ CLI tools for syntax checking (check), AST output (build)

📆 Installation

For users

• ⚠️ Requires Node.js 18+

Install the package globally (NPM)

npm install -g @devaloop/devalang

Usage without install (NPX)

npx @devaloop/devalang <command>

For contributors

• ⚠️ Requires Node.js 18+
• ⚠️ Requires Rust 1.70+

> git clone https://github.com/devaloop-labs/devalang.git
> cd devalang
> npm install
> cargo install --path .

Usage for development (feel free to change arguments in package.json)

# For syntax checking test
npm run rust:dev <command>

❔ Usage

For more examples, see docs/COMMANDS.md

Checking syntax only and output debug files

devalang check --entry <entry-directory> --output <output-directory>

Building output file(s) (AST generation for the moment)

devalang build --entry <entry-directory> --output <output-directory>

📄 Syntax example

For more examples, see docs/SYNTAX.md

# index.deva

@import { globalBpm, globalBank, kickDuration } from "global.deva"

bpm globalBpm
# Will declare the tempo at the globalBpm variable beats per minute

bank globalBank
# Will declare a custom instrument bank using the globalBank variable

loop 5:
    .kick kickDuration {reverb=50, drive=25}
    # Will play 5 times a kick for the duration of the kickDuration variable with reverb and drive effects

# global.deva

let globalBpm = 120
let globalBank = 808
let kickDuration = 500 

@export { globalBpm, globalBank, kickDuration }

🧯 Known issues

• No support yet for Audio Engine
• No support yet for if, else, else if statements
• No support yet for @group, @pattern, @function statements
• Nested loops and conditions may not be fully tested

🧪 Roadmap Highlights

For more info, see docs/ROADMAP.md

• ⏳ Audio engine integration
• ⏳ Other statements (e.g if, @group, ...)
• ⏳ Watch mode for automatic rebuilds

🛡️ License

MIT — see LICENSE

🤝 Contributing

Contributions, bug reports and suggestions are welcome !
Feel free to open an issue or submit a pull request.

📢 Contact

📧 contact@devaloop.com