Upload files to "/"

README.md

@@ -1,2 +1,80 @@
-# Claro
+# Claro 1.0
 
+Beginner-friendly programming for everyone.
+
+Claro is a simple, readable programming language designed to make coding accessible to new learners, classrooms, and people with learning differences.
+
+---
+
+# Running Claro
+
+Interactive mode:
+    claro
+
+Run a program:
+    claro program.claro
+
+Classroom safe mode:
+    claro --classroom program.claro
+
+---
+
+# Your first program
+
+Create a file called hello.claro
+
+SAY "Hello, world!"
+
+Run it:
+claro hello.claro
+
+---
+
+# Core Commands
+
+SAY — show output
+ASK — get input
+SET — store data
+IF — make decisions
+DO — repeat a number of times
+WAIT — pause the program
+
+---
+
+# Functions with TEACH
+
+TEACH add TAKES a, b
+    RETURN a + b
+LEARNED
+
+CALL add WITH 2, 3
+SAY RESULT
+
+---
+
+# Sprites
+
+CREATE SPRITE player
+MOVE SPRITE player TO 10 5
+SHOW SPRITE player
+HIDE SPRITE player
+
+---
+
+# Project Structure
+
+bin/        → compiled Claro executable  
+docs/       → guides and classroom material  
+examples/   → sample programs  
+tests/      → test programs  
+src/        → interpreter source code  
+
+---
+
+# License
+
+MIT License
+
+---
+
+Claro 1.0 — Simple. Readable. For everyone.