[GH-ISSUE #5802] [Bug] theme file questions #2584

New issue

Open

opened 2026-03-23 21:23:34 +00:00 by mirror · 1 comment

mirror commented

2026-03-23 21:23:34 +00:00

Owner

Originally created by @arhadrian on GitHub (Jul 24, 2024).
Original GitHub issue: https://github.com/AppFlowy-IO/AppFlowy/issues/5802

Bug Description

First of all, I am grateful for your product and the features you offer.
I wanted to customize the theme, I followed all the steps in your manual page, but no matter what I changed in the template, it was not reflected in the interface. I tried to understand the lines of code in the themes, but I am not sure I understood everything. For instance, I could not identify the background color line in the code, to change the transparency and color. I completely understood the codes for both, by the way, and I have no problems in writing the transparency or color code in those lines.
Any advise will be highly appreciated!

How to Reproduce

Change the transparency and color codes in the json files, upload in the app the theme and apply it.

Expected Behavior

The UI should change colors and transparencies for various elements

Operating System

Windows

AppFlowy Version(s)

latest, just downloaded today

Screenshots

No response

Additional Context

No response

Originally created by @arhadrian on GitHub (Jul 24, 2024). Original GitHub issue: https://github.com/AppFlowy-IO/AppFlowy/issues/5802 ### Bug Description First of all, I am grateful for your product and the features you offer. I wanted to customize the theme, I followed all the steps in your manual page, but no matter what I changed in the template, it was not reflected in the interface. I tried to understand the lines of code in the themes, but I am not sure I understood everything. For instance, I could not identify the background color line in the code, to change the transparency and color. I completely understood the codes for both, by the way, and I have no problems in writing the transparency or color code in those lines. Any advise will be highly appreciated! ### How to Reproduce Change the transparency and color codes in the json files, upload in the app the theme and apply it. ### Expected Behavior The UI should change colors and transparencies for various elements ### Operating System Windows ### AppFlowy Version(s) latest, just downloaded today ### Screenshots _No response_ ### Additional Context _No response_

mirror added the

labels

2026-03-23 21:23:34 +00:00

mirror commented

2026-03-23 21:23:34 +00:00

Author

Owner

@alexrosepizant commented on GitHub (Mar 22, 2026):

Hey! The JSON format for AppFlowy themes can be a bit confusing at first — colors are encoded as 0xAARRGGBB (not standard hex), where the first two digits control transparency and the last six are the RGB color. So for example a fully opaque red would be 0xFFFF0000.

Also worth knowing: not everything in the UI is controllable via the theme JSON. Some elements like primary buttons are hardcoded in Flutter and won't change no matter what you put in the file.

If it helps, I made a small browser-based generator that handles the color format for you and shows a live preview of what actually changes: AppFlowy-Theme-Generator

Hope that helps!

@alexrosepizant commented on GitHub (Mar 22, 2026): Hey! The JSON format for AppFlowy themes can be a bit confusing at first — colors are encoded as `0xAARRGGBB` (not standard hex), where the first two digits control transparency and the last six are the RGB color. So for example a fully opaque red would be `0xFFFF0000`. Also worth knowing: not everything in the UI is controllable via the theme JSON. Some elements like primary buttons are hardcoded in Flutter and won't change no matter what you put in the file. If it helps, I made a small browser-based generator that handles the color format for you and shows a live preview of what actually changes: [AppFlowy-Theme-Generator](https://alexrosepizant.github.io/AppFlowy-Theme-Generator/) Hope that helps!

mirror referenced this issue

2026-03-23 22:18:12 +00:00

[PR #2584] [CLOSED] fix: added more simplified chinese translation. #5318