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

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

diff --git a/docs/IMPORTS.md b/docs/IMPORTS.md
new file mode 100644
index 0000000..7b5c64a
--- /dev/null
+++ b/docs/IMPORTS.md
@@ -0,0 +1,26 @@
+# Imports in Claro
+
+## Basic
+```claro
+IMPORT "lib/text.claro" AS text
+```
+
+## How paths resolve
+When you write `IMPORT "something.claro"` Claro searches in this order:
+
+1. Relative to the importing file’s folder  
+2. Each folder listed in the `CLARO_PATH` environment variable  
+   - separate entries with `;` or `:`  
+3. The current working directory
+
+## CLARO_PATH example
+
+### Windows
+```bat
+set CLARO_PATH=C:\claro\lib;C:\mygame\scripts
+```
+
+### Linux/macOS
+```sh
+export CLARO_PATH=/opt/claro/lib:/home/me/project/scripts
+```