🚀 Get Started

Use this page to pick the fastest path to a first successful run.

Choose your path

• First-time user (5-10 min): 🖥️ Use on Host
• Integrator (15-30 min): 🖥️ Use on Host
• WASM app developer (10-20 min): 🌐 Use on WASM
• Contributor (20-40 min): 🤝 Contribute

Checklist links:

• Host preflight checklist
• WASM preflight checklist
• Contributor preflight checklist

Preflight checklist

Before you start, confirm:

• Rust is installed: rustc --version
• Cargo works: cargo --version
• You chose one target path (host, wasm, or contribution)
• You can run commands from a clean project folder

Quick start commands

Pick one path and run the matching command sequence:

Host

git clone https://github.com/Xila-Project/Core.git
cd Core
cargo make run -p native_example

WASM

git clone https://github.com/Xila-Project/Core.git
cd Core
rustup target add wasm32-wasip1
cargo build -p wasm --target wasm32-wasip1

Contributor

git clone https://github.com/Xila-Project/Core.git
cd Core
cargo make before-commit

Success outcomes

You are "started" when you can do one of these:

• Host path: run a host app and see it start without panics
• Integrator path: initialize modules, mount runtime services, and launch one executable in your workspace
• WASM path: build a wasm32-wasip1 binary without target errors
• Contributor path: run both native and wasm examples locally

Troubleshooting

• cargo make: command not found: install cargo-make (cargo install cargo-make).
• target missing errors for wasm: run rustup target add wasm32-wasip1.
• build failures after dependency updates: run formatting/check tasks from contribute.md.

Architecture maps

Use these while onboarding to understand the system boundaries:

• Modules architecture map
• Crates architecture map
• Executables architecture map

Next steps

• Continue with 🖥️ Use on Host for local runtime setup.
• Continue with 🌐 Use on WASM for guest app workflow.
• Continue with 🤝 Contribute for contributor workflow.