KidCode is an educational programming language and visual interpreter designed to teach programming concepts through instant visual feedback. Control a turtle named "Cody" to draw, create patterns, and learn coding fundamentals interactively!

This project is organized as a Maven multi-module repository:

• kidcode-core: Headless, event-driven core logic (lexer, parser, AST, evaluator, event API)
• kidcode-desktop: Desktop application (Swing GUI) and CLI runner, consuming the core event API
• kidcode-web: Spring Boot backend (REST API) and modern web frontend (Monaco editor, live validation, HTML5 canvas)

• Variables, Arithmetic, Lists: Store/manipulate values, collections, and perform calculations
• Loops & Conditionals: repeat, if/else for control flow
• Functions: Define reusable commands
• String Operations: Concatenate and display messages

• Real-time Visualization: Watch Cody draw on canvas (desktop & web)
• Pen & Color Control: pen up/down, color commands
• Modern Web Editor: Monaco-based code editor with syntax highlighting and live validation
• Output Panel: See logs, errors, and messages
• Execution Control: Stop/clear execution at any time

• REST API: /api/execute runs code, /api/validate checks syntax (JSON events/errors)
• Web UI: Monaco editor, live error squiggles, HTML5 canvas, responsive design

• Execution Timeout: Prevents infinite loops
• Graceful Error Handling: Clear, line-numbered diagnostics
• Responsive UI: Remains interactive during execution

• Java 17 or higher
• Maven

# Clone the repository
 git clone <repository-url>
 cd KidCode

# Build all modules
 mvn clean package

cd kidcode-desktop
mvn exec:java -Dexec.mainClass="com.kidcode.gui.KidCodeVisualInterpreter"

Or run the CLI:

cd kidcode-desktop
mvn exec:java -Dexec.mainClass="com.kidcode.cli.CommandLineRunner" -Dexec.args="../test_scripts/<script.kc>"

cd kidcode-web
mvn spring-boot:run

Then open http://localhost:8080 in your browser.

(See original README for full table and examples)

Example and test scripts can be found in the test_scripts/ folder at the project root.

• kidcode-core: Pure Java, event-driven. Exposes a sealed ExecutionEvent API (Move, Say, Error, Clear, etc.) for UI-agnostic consumption.
• kidcode-desktop: Swing GUI and CLI, visualizes events from the core.
• kidcode-web: Spring Boot REST API (/api/execute, /api/validate) and static frontend (Monaco editor, canvas, output log).

The core emits events (move, say, error, clear, etc.) as code executes. Both desktop and web UIs consume these events to update the UI or canvas.

• POST /api/execute — Run KidCode, returns a list of events as JSON
• POST /api/validate — Validate code, returns syntax errors (for Monaco squiggles)

• Monaco Editor: Professional code editing, syntax highlighting, and error squiggles
• Live Validation: Errors shown instantly as you type
• HTML5 Canvas: Visualizes Cody's drawing
• Output Log: See messages and errors

Contributions are welcome! Please fork, branch, and submit a pull request.

MIT License

Happy Coding with KidCode! 🎨✨