Novus, from zero to real projects

This guide walks through installing Novus and Nox, creating a project, using std, writing inline assembly, and understanding how real Novus projects are structured.

What this repo covers

• First project — from nox init to your first compiled binary
• Language tour — modules, imports, functions, arrays, strings, overloads, and #if
• Inline assembly — mov, getreg, syscall, and win_call
• Working with std — standard library usage and common patterns
• Platformer walkthrough — rendering loop, input handling, camera, and window API
• Todo app walkthrough — a simple CLI app with file-backed storage

Compatibility snapshot

These docs were written against the currently installed toolchain on this machine:

• Novus compiler: V0.2.0
• Novus repo: 753ee3c
• Nox repo: 632c8be
• window library: 1.1.1
• std examples: based on current ecosystem usage in the linked repos

Recommended reading order

1. Install Novus and Nox
2. Install Novus and Nox
3. Your First Project
4. Language Tour
5. Working with std
6. Nox and Libraries
7. Inline Assembly
8. Project walkthroughs

When to use the AI docs

If you are building tooling, generating Novus code automatically, or teaching an AI agent how to reason about a Novus repo, start with:

• AI reference
• root-level AI_GUIDE.md
• root-level llms.txt

Related repositories

• Novus
• Nox
• Todo-App
• platformer-game