Bro-code is a toy programming language written in TypeScript with its own custom tokenizer, recursive-descent parser, AST, and tree-walking interpreter.
- Website / Docs: https://ClaudeMaxUser.github.io/bro-code/
- Interactive Web Playground: https://ClaudeMaxUser.github.io/bro-code/#playground
Minimal program:
hi bro
say bro "Hello bro";
bye broExpected output:
Hello bro
Every executable program starts with hi bro and ends with bye bro.
Anything outside those boundaries is ignored.
This will be ignored
hi bro
// code here
bye bro
This too- Single-line comments:
// ... - Multi-line comments:
/* ... */
hi bro
// single line comment
/*
multi line comment
*/
say bro "comments work";
bye broDeclare variables with bro this is.
hi bro
bro this is a = 10;
bro this is b = "two";
bro this is c = 15;
a = a + 1;
b = 21;
c *= 2;
bye bro- Number:
10,20.5 - String:
"hello",'hello' - Null:
nope - Boolean true:
yep - Boolean false:
nah
hi bro
bro this is a = 10;
bro this is b = 10 + (15 * 20);
bro this is c = "two";
bro this is d = 'ok';
bro this is e = nope;
bro this is f = yep;
bro this is g = nah;
bye broUse say bro to print values.
hi bro
say bro "Hello World";
bro this is a = 10;
{
bro this is b = 20;
say bro a + b;
}
say bro 5, 'ok', nope, yep, nah;
bye broSupported operators include:
- Arithmetic:
+,-,*,/,% - Assignment:
=,+=,-=,*=,/=,%= - Equality:
==,!= - Relational:
>,<,>=,<= - Logical:
&&,||
Notes:
- String concatenation is supported with
+. - Arithmetic with
nopeor boolean values can throw runtime errors. - Division by zero throws a runtime error.
Use if bro, else if bro, and else bro.
hi bro
bro this is a = 10;
if bro (a < 20) {
say bro "a is less than 20";
} else if bro (a < 25) {
say bro "a is less than 25";
} else bro {
say bro "a is greater than or equal to 25";
}
bye broUse while bro for loops.
stop brobreaks the loop.next brocontinues to next iteration.
hi bro
bro this is a = 0;
while bro (a < 10) {
a += 1;
if bro (a == 5) {
say bro "inside loop:", a;
next bro;
}
if bro (a == 6) {
stop bro;
}
say bro a;
}
say bro "done";
bye broBlocks create scope with { ... }.
hi bro
bro this is a = 10;
{
bro this is b = 20;
say bro a + b;
}
bye broBro code follows a modular pipeline:
- Tokenizer converts source code into tokens from grammar spec.
- Parser builds an AST from the token stream.
- Interpreter evaluates AST nodes using node-type visitors.
- Playground (web app) runs code in-browser via interpreter package.
flowchart LR
A[Bro code source] --> B[Tokenizer]
B --> C[Parser]
C --> D[AST]
D --> E[Interpreter visitors]
E --> F[Runtime output]
apps/docs: Next.js docs + playground UI.packages/parser: grammar, tokenizer, parser, AST node definitions.packages/interpreter: runtime evaluator and scope handling.packages/cli: command-line entrypoint for local file execution.packages/config: shared ESLint config package.packages/tsconfig: shared TypeScript config package.
- Language implementation is fully in TypeScript.
- Parser and interpreter are separated into independent packages.
- Interpreter uses visitor dispatch by AST node type.
- Runtime scope is reset after each interpretation cycle.
- Turborepo manages builds, tests, and package orchestration.
- Dynamically typed runtime semantics.
- Block-scoped variable behavior.
- Explicit runtime exceptions for invalid operations.
- Control flow support for conditional branches and loops.
- Node.js >= 18
- npm >= 7
git clone https://github.com/ClaudeMaxUser/bro-code.git
cd bro-code
npm install# Start local docs & playground development server
npm run dev
# Run all test suites across packages
npm run test
# Lint all workspaces
npm run lint
# Build all packages & export docs site
npm run build
# Format code with Prettier
npm run format- Website & Documentation: https://ClaudeMaxUser.github.io/bro-code/
- Interactive Playground: https://ClaudeMaxUser.github.io/bro-code/#playground
- GitHub Repository: https://github.com/ClaudeMaxUser/bro-code
MIT