Files
Claro/docs/V1_16_PACKAGES_PROJECTS.md

1.5 KiB

Claro v1.18.26 - Packages and Projects

Claro v1.18.26 makes projects and packages safer and more useful while keeping the beginner syntax simple.

Create a project

claro new MyProject
cd MyProject
claro run

A new project contains:

main.claro
claro.project
claro.lock
packages/
README.md

Project file

claro.project is intentionally plain text:

manifest-version: 1
name: MyProject
main: main.claro
version: v1.18.26
packages:
package: text
package: net_tools

Package commands

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:

packages/NAME/
  claro.package
  README.md

Each claro.package file includes a tiny manifest and checksum:

manifest-version: 1
name: text
version: 1
source: local
checksum: 1234abcd

claro.lock records the release version, lock format, packages, and checksums so future registry work has a stable safety foundation.

Safety rules

Package names may use only:

letters
numbers
dash
underscore

This means simple names like these are allowed:

text
sdl
net_tools
my-package

Unsafe names are rejected:

../bad
folder/name
bad name

Why this matters

Packages are important for Claro's future, but the workflow must stay friendly:

make a project
add a package
run the project
check the project

No complicated setup should be needed for a beginner.