fryorcrakenandClaude Sonnet 4.6
410f4abb68
Without a .gitignore, vendored C library binaries (lib/*.so, lib/*.dylib, lib/*.a) and the Nix result symlink get staged by git add -A. Add a .gitignore block to the tutorial so readers exclude them from the start. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
logos-tutorial
Tutorial series and reference documentation for building Logos modules.
Start Here
New to Logos? Start with the developer guide -- it walks through creating, building, packaging, and running your first module:
Next Tutorials
Step-by-step tutorials that build on each other. Each creates a working module you can run.
-
Part 1: Wrapping a C Library -- build
calc_module, a core module that wraps a C library (libcalc). Covers external library configuration, CMake integration, building, inspecting withlm, testing withlogoscore, and packaging withnix-bundle-lgx. -
Part 2: Building a QML UI App -- build
calc_ui, a QML-only UI plugin that callscalc_modulethrough thelogos.callModule()bridge. No compilation needed. -
Part 3: Building a C++ UI Module -- build
calc_ui_cpp, a native C++ Qt widget plugin with typed backend calls tocalc_moduleviaLogosAPI*.
Example Modules
Working module source code used by the tutorials:
| Directory | Module | Type | Tutorial |
|---|---|---|---|
logos-calc-module/ |
calc_module |
Core (wraps libcalc) | Part 1 |
logos-calc-ui/ |
calc_ui |
QML UI | Part 2 |
logos-calc-cpp-ui/ |
calc_ui_cpp |
C++ UI | Part 3 |