FlxOS Documentation

git clone --recurse-submodules https://github.com/flxos-labs/flxos.git
cd flxos

flxos/
├── Applications/    # User-facing apps (calendar, files, text editor, settings, ...)
├── Apps/            # App framework and lifecycle management
├── Buildscripts/    # CMake modules, profile loader, HW code generator
├── Connectivity/    # WiFi, networking modules
├── Core/            # Core OS headers and utilities
├── Firmware/        # Firmware entry point and initialization
├── HalModule/       # Hardware Abstraction Layer
├── Kernel/          # Kernel services (tasks, memory, logging)
├── Profiles/        # Board/device profiles (YAML + generated config)
├── Services/        # System services
├── System/          # System-level modules (drivers, buses)
├── UI/              # LVGL UI framework, themes
├── flxos.py         # Main CLI build tool
└── CMakeLists.txt   # Top-level CMake project file

# Standard build
python flxos.py build

# Dev build with faster iterations
python flxos.py build --dev

# Flash and connect monitor
python flxos.py flash --port /dev/ttyUSB0

python flxos.py list
python flxos.py diff a b --json

#pragma once
#include "App.hpp"

class MyApp : public App {
public:
    MyApp() : App("MyApp", "My Application") {}
    
    void onCreate() override {
        // Initialize your app UI
        lv_obj_t* label = lv_label_create(getContainer());
        lv_label_set_text(label, "Hello, FlxOS!");
    }
    
    void onResume() override {
        // App brought to foreground
    }
    
    void onPause() override {
        // App sent to background
    }
};