From e59b39d0ea4be403555ad7987853930965eee950 Mon Sep 17 00:00:00 2001
From: RayPals <raypals@noreply.codeberg.org>
Date: Tue, 17 Feb 2026 22:59:38 +0100
Subject: [PATCH] Upload files to "/"

---
 README.md | 80 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 79 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 7382bd2..df44f32 100644
--- a/README.md
+++ b/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.