From d1250c013cc1865a5e4b1d8d9a3032b414d1d64b Mon Sep 17 00:00:00 2001
From: RayPals <raypals@noreply.codeberg.org>
Date: Mon, 1 Jun 2026 00:53:32 +0200
Subject: [PATCH] Add docs/V1_16_PACKAGES_PROJECTS.md from Claro v1.17.26 zip

---
 docs/V1_16_PACKAGES_PROJECTS.md | 94 +++++++++++++++++++++++++++++++++
 1 file changed, 94 insertions(+)
 create mode 100644 docs/V1_16_PACKAGES_PROJECTS.md

diff --git a/docs/V1_16_PACKAGES_PROJECTS.md b/docs/V1_16_PACKAGES_PROJECTS.md
new file mode 100644
index 0000000..76bddb2
--- /dev/null
+++ b/docs/V1_16_PACKAGES_PROJECTS.md
@@ -0,0 +1,94 @@
+# Claro v1.17.26 - Packages and Projects
+
+Claro v1.17.26 makes projects and packages safer and more useful while keeping the beginner syntax simple.
+
+## Create a project
+
+```bash
+claro new MyProject
+cd MyProject
+claro run
+```
+
+A new project contains:
+
+```text
+main.claro
+claro.project
+claro.lock
+packages/
+README.md
+```
+
+## Project file
+
+`claro.project` is intentionally plain text:
+
+```text
+name: MyProject
+main: main.claro
+version: v1.17.26
+packages:
+package: text
+package: sdl
+```
+
+## Package commands
+
+```bash
+claro package init
+claro package add text
+claro package remove text
+claro package list
+claro package doctor
+claro package lock
+```
+
+`claro package add NAME` creates a local folder:
+
+```text
+packages/NAME/
+  claro.package
+  README.md
+```
+
+## Safety rules
+
+Package names may use only:
+
+```text
+letters
+numbers
+dash
+underscore
+```
+
+This means simple names like these are allowed:
+
+```text
+text
+sdl
+net_tools
+my-package
+```
+
+Unsafe names are rejected:
+
+```text
+../bad
+folder/name
+bad name
+```
+
+## Why this matters
+
+Packages are important for Claro's future, but the workflow must stay friendly:
+
+```text
+make a project
+add a package
+run the project
+check the project
+```
+
+No complicated setup should be needed for a beginner.