Ignis WLED Controller

A comprehensive toolkit for controlling juggling light toys using the WLED library. This project collects existing implementations and offers a new cross-platform application based on Expo React Native.

Project Overview

• WLED Library: Core library for controlling LED lights with ESP32/ESP8266
• Native iOS and Android apps: Existing implementations for experimentation
• Expo React Native app: New cross-platform implementation with modern UI

Project Structure

ignis-wled-controller/
├── apps/                 # Application code
│   ├── ios-native/       # iOS implementation (for experiments)
│   ├── android-native/   # Android implementation (for experiments)
│   └── expo-app/         # Expo React Native application
├── packages/             # JavaScript/TypeScript shared packages
│   └── shared/           # Shared components and utilities
├── external/             # External submodules
│   └── wled/             # WLED library as a submodule
└── docs/                 # Documentation
    ├── en/               # English documentation
    └── cs/               # Czech documentation

Getting Started

Prerequisites

• Node.js (v18 or later)
• Bun for package management
• Nx for monorepo management

Cloning the Repository

git clone https://github.com/miccy/ignis-wled-controller.git
cd ignis-wled-controller
git submodule update --init --recursive

Installing Dependencies

bun install

Development Workflow

This project uses Nx for monorepo management and Bun for JavaScript dependencies.

Building Projects

nx run-many --target=build

To build a specific project:

nx build expo-app

Running Tests

nx run-many --target=test

To test a specific project:

nx test expo-app

WLED API Integration

This project is built around the WLED API for controlling LED devices. For details on how we use the API, see:

• WLED API Overview (English)
• Přehled WLED API (Česky)

License

• Expo React Native app: MIT License
• WLED library: EUPL-1.2
• Other implementations: See respective repositories

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

Documentation

• English Documentation
• Czech Documentation

Acknowledgments

• Authors of the original WLED library
• Creators of the native iOS and Android implementations
• Expo React Native community