Kodme

A simple, beginner-friendly programming language for learning programming concepts.

Playground • Documentation • Contributing

---

✨ Features

Feature	Description
📝 Readable Syntax	Code that reads like English sentences.
🎮 Interactive	Built-in ask and show for fun interactions.
🔄 Loops Made Easy	Simple repeat loops for patterns and games.
decisions Logic	Clear if, else structures for decision making.
🎨 Playground	A beautiful, kid-friendly web editor to start coding instantly.

🛠️ Installation

Click to see installation steps

1. Clone the repository

   git clone https://github.com/rinturaj/kodme.git
   cd kodme

2. Install dependencies

   pnpm install

3. Build the project

   pnpm build

🏃‍♂️ Running Kodme

You can run Kodme programs in two ways:

1. Interactive Mode 💬 Start the REPL and type code directly: pnpm start

2. Run a File 📄 Execute a specific .kodme file: pnpm start path/to/program.kodme

🚀 Getting Started

Here's a simple example program in Kodme. Create a file named hello.kodme:

# Ask for user's name and greet them
name = ask "What is your name?"
show "Hi " name

# Count from 1 to 5
x = 1
repeat until x > 5
    show x
    x = x + 1

Run it with:

pnpm start hello.kodme

📚 Language Reference

📦 Variables

name = "Alice"
age = 10
isCool = true

🗣️ Input/Output

name = ask "Who are you?"
show "Welcome, " name

🔀 Conditionals

if age > 18
    show "Adult"
else
    show "Kid"

🔄 Loops

# Repeat 5 times
repeat 5
    show "Kodme is fun!"

# Repeat until condition
count = 0
repeat until count == 3
    show count
    count = count + 1

📂 Project Structure

• /packages/core - The brain of Kodme (Lexer, Parser, Interpreter).
• /apps/playground - The beautiful web interface for coding.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT