Set up repository structure for examples and testing

[ewowi]

Overview

Establish the foundational structure of this repository so contributors can add animation examples and run tests against the latest FastLED master.

Tasks

• Define a folder structure (e.g. examples/, tests/, docs/)
• Add a basic example template that contributors can copy as a starting point
• Set up a CI pipeline to build and test examples against FastLED master
• Document the contribution workflow in CONTRIBUTING.md
• Add a README to each top-level folder explaining its purpose

Open Questions

• Should examples be organized by feature area (audio, GFX, channels, etc.) or kept flat?
• What hardware targets should CI cover?
• Should wasm builds be part of the default CI run?
• Use wokwi ?

Definition of Done

The repo is structured so that a new contributor can clone it, find an example, modify it, and submit a pull request — with CI validating their changes automatically.

[zackees]

There are special qualities to the main repo, specifically everything under examples/ and tests/ is under compile test and is guaranteed to compile and run if the main repo is green across the board.

Additionally 'fastled' wasm app has a special mode for repo syncing -- you can make changes to both the sketch and the engine and the app will recompile everything necessary. This is critical to rapid development and I leverage this constantly. The way everyone is else is doing it with wowki and forked repos works ok and is certainly better than being blocked on me for a fix, but it's far inferior to using fastled-wasm which takes care of the whole pipeline

An external repo loses all these guarantees.

The upside of an external repo is that it's simpler to grok, you don't have all source code.

Here's my ideal scenario for devs, and tell me if you disagree:

fork fastled, use fastled-wasm to build / tune feature X, then send a PR

I feel that this playground belongs in the main repo and be made to be part of the examples folder, unless it's primary goal is to be sort of an examples folder for artists.