Gabor Kiss-VamosiandClaude Opus 4.8
fbb5007d83
Deprecate the rlottie player. The ThorVG-based lv_lottie widget is part of LVGL and needs no external library. Following the deprecation guidelines: - @deprecated Doxygen tags and LV_DEPRECATED on the rlottie create functions - LV_LOG_DEPRECATED runtime warning in both create functions - migration-v10.mdx entry pointing to lv_lottie The rlottie docs page already carries a deprecation callout. Live call sites in the kept examples are wrapped with LV_DEPRECATIONS_IGNORE_BEGIN/END so the -Wdeprecated -Werror build stays clean. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Documentation
LVGL documentation is authored in MDX. The rendering site that serves these pages is maintained separately by the LVGL team — contributors here author and review .mdx content under ./src/.
Local preview Docker image — coming soon. We will publish an image on GHCR (
ghcr.io/lvgl/lvgl-docs— exact tag TBD) that bundles the docs site and serves this./src/content athttp://localhost:3000.
Everything Must Be Documented
Our firm policy: EVERYTHING MUST BE DOCUMENTED. Public APIs, widgets, features, and configuration options all need an MDX page or section. When in doubt, add it.
Where Content Lives
All MDX pages live under ./src/. The directory structure drives the URL, and sidebar ordering is controlled by meta.json files inside each directory.
A page is a .mdx file with YAML frontmatter:
---
title: Animations
description: Animate widget properties over time with the LVGL animation engine.
---
# Animations
Animations change a property's value over a period of time...
<LvglExample name="lv_example_anim_1" path="anim/lv_example_anim_1" />
Common Components
A small set of components covers most authoring needs:
<Callout type="info|warn|error" title="...">— notes, warnings, tips.<LvglExample name="..." path="..." />— embed a runnable code example.<ApiLink name="lv_label_create" />— inline link to an API symbol.<ApiLinkList items={["lv_label"]} />— link out to related API pages at the end of a page.<Figure src="/_static/images/..." alt="..." caption="..." />— images with captions.<DirectoryIndex />— auto-generated list of child pages on index pages.
The full component catalog, formatting rules, meta.json examples, and icon list live in Writing Docs. Start there for anything beyond the components above.
More on Contributing
For coding style, DCO, pull requests, and other contribution guidelines, see the pages under ./src/contributing/.