Gen Z Lang

A programming language that speaks your language (literally). Gen Z Lang uses Gen Z and Gen Alpha slang for programming commands, making code read like texting between friends.

Installation

Use directly without installation:

./genz examples/hello.genz

Quick Start

Create a file called hello.genz:

ngl This is a hello world program
yeet "Hello, World!"
fr fr "No cap, this language is bussin!"

Run it:

genz hello.genz

Syntax Quick Reference

Variables

rizz x = 10          # Declare variable
x = 20               # Reassign

Output

yeet "Hello"         # Print
fr fr "Important!"   # Emphasized print

Input

rizz name = vibe check "What's your name? "

Comments

ngl This is a single-line comment
tea: This is a
multi-line comment :tea

Conditionals

vibe? x highkey > 10:
  yeet "x is big"
no vibe? x highkey > 5:
  yeet "x is medium"
dead:
  yeet "x is small"

Loops

keep slaying while x lowkey < 10:
  yeet x
  x = x + 1

grind from i = 1 to 10:
  yeet i

Functions

main character greet(name):
  yeet "Hello, "
  yeet name
  send it bussin

greet("World")

Operators

Math: +, -, *, /, %, ^

Comparison:

• no cap - equals (==)
• cap - not equals (!=)
• lowkey < - less than
• highkey > - greater than
• lowkey <= - less than or equal
• highkey >= - greater than or equal

Logical: and, or, nah (not)

Booleans: bussin (true), mid (false)

Control Flow: dip (break), skip it (continue)

Built-in Functions

glow_up(x)       # Convert to int
vibe_shift(x)    # Convert to string
energy(x)        # Convert to float

Examples

See the examples/ directory for more programs:

• hello.genz - Hello world
• calculator.genz - Variables and math
• fizzbuzz.genz - FizzBuzz implementation
• functions.genz - Function definitions
• guessing_game.genz - Interactive game

Comprehensive Documentation

For building complex software or passing to AI systems, see the docs/ directory:

📚 Complete Documentation Suite

1. docs/INDEX.md - Start here! Navigation guide for all documentation
2. docs/LANGUAGE_SPEC.md - Complete formal language specification
3. docs/ADVANCED_GUIDE.md - Design patterns, algorithms, and complex applications
4. docs/API_REFERENCE.md - Quick reference and cheat sheet
5. docs/INTERNALS.md - Implementation details and extension guide

🎯 Quick Links by Purpose

Learning Gen Z Lang:

• Language Specification - Complete guide
• API Reference - Quick syntax lookup

Building Complex Software:

• Advanced Guide - Patterns and architectures
• Example Applications - Complete apps

Extending the Language:

• Internals - Architecture and implementation
• Extension Guide - Add features

For AI Systems:

• Documentation Index - Which doc to use when
• All docs are AI-optimized with complete specifications

Language Philosophy

Gen Z Lang is designed to be:

• Fun: Code should feel like texting with friends
• Expressive: Gen Z slang is rich and descriptive
• Educational: Learn programming concepts through familiar language
• Authentic: Uses real Gen Z and Gen Alpha terms

Contributing

Contributions are welcome! Feel free to:

• Add more Gen Z slang keywords
• Improve error messages
• Create example programs
• Enhance the standard library

License

MIT