Add theme-docs

theme-docs.-.md

@@ -0,0 +1,84 @@
+# MB Themes (WIP)
+
+## Official themes
+
+MB's Flutter official themes are stored in 2 places :
+
+1. Bulit-in themes (base/priority/private/foreign/{specific} : `MB.apk/assets/flutter/assets/images/dynamic/` with WEBP format since `v6.4.43` and PNG format for `v6.4.42` or lower.
+- You can still use PNG/JPEG/JPG images, just need to rename file extension to `.webp` after then
+- Some specific themes for each season, like : `noel` `quockhanh` `tuhaoVietNam` are only present on some specific version and will be removed in future version, for example `v6.4.45` does have `tuhaoVietNam` theme, but `v6.4.48+` removed it
+
+
+2. Store themes : Downloadable themes on MB Store, can be access on MB -> Settings/Install -> Change Theme -> "CHỢ THEME MB" and will be store on `/data/data/com.mbmobile/app_flutter/app_theme/unzip`
+- Those store themes also stored here by me :  [MB Flutter Themes](https://git.disroot.org/mbcp/tweaked-mbflutter-themes/src/branch/main/community_themes/template)
+
+# Unofficial themes 
+
+Unofficial theme are all made by community and mine, based from a one of official themes above as color palette or modified to a specific color palette that doesn't exist on any of above official themes.
+
+- Premade themes can be found here :
+
+[Disroot](https://git.disroot.org/mbcp/tweaked-mbflutter-themes/releases)
+
+[GitLab releases (deprecated)](https://gitlab.com/mbcp/tweaked-mbflutter-themes/-/releases)
+
+# Custom themes
+
+If you want to customize MB store themes or made your own theme, you can follow my docs below :
+
+1. Customize app background :
+
+- Theme file structure will be like this 
+```
+└── {theme-id}
+    ├── images
+    │   ├── bill_background_gold.png
+    │   ├── coreBanking_img_successBackground.png
+    │   ├── eMBee_img_header.png
+    │   ├── general_bg_screenshot.png
+    │   ├── general_bg_success.png
+    │   ├── general_illus_success.png
+    │   ├── homeLanding_bg_main.png
+    │   ├── homeLanding_img_avatarDefault.png
+    │   ├── homeLanding_img_banner.png
+    │   ├── homeLanding_img_dividerShadow.png
+    │   ├── homeLanding_img_PFM.png
+    │   ├── loading_bg_main.png
+    │   ├── login_bg_main.png
+    │   ├── qr_img_ThemeDefalut.png
+    └── theme
+        └── token.json
+```
+
+- Banner `homeLanding_img_defaultBanner.webp` only appears to be inside app assets under `/flutter_assets/assets/images/dynamic/base/` but you can literally create another `homeLanding_img_defaultBanner.webp` on theme and then it's will also take effects.
+
+- All of those files : `homeLanding_bg_main.png` | `login_bg_main.png` | `loading_bg_main.png` | `coreBanking_img_successBackground.png` | `general_bg_success.png` | `qr_img_ThemeDefalut.png`| are mostly in the same resolution : `2436x2436` or `2437x2437`
+
+- You can literally replace most of above images with any images (except `homeLanding_img_avatarDefault.png`) , not matter if it's `2436x2436` or not. Recommended resolution is `1080x1920` or `1080x2300`
+- Don't made it too big, like a bee with 100MB and big resolution as its will make app crash or freeze your device
+
+2. Explain the place of those themes :
+
+- `homeLanding_img_avatarDefault.png` are the default profile picture and did not appears if you setup custom profile picture. There is no way to restore to default profile picture than use new account. Recommended size : `500x500`
+
+- `homeLanding_img_defaultBanner.webp` are present on homeLanding, under main function | [See example screenshot](https://gitlab.com/mbcp/info/-/wikis/uploads/f072d65ff1b1b0fe0a12a49783a8b11f/image.png)
+
+- `bill_background_gold.png` are present on successful transaction screen for Private users (idk)
+
+- `loading_bg_main.png` are present during early app open | [See example screenshot](https://gitlab.com/mbcp/info/-/wikis/uploads/1a4c7b11a764e0a29db5a1a7c8f127b3/image.png)
+
+- `login_bg_main.png` are present on app login screen | [See example screenshot](https://gitlab.com/mbcp/info/-/wikis/uploads/8f6e8be7049c228d4e13d2a3048a21a5/image.png)
+
+- `homeLanding_bg_main.png` are present on homepage after logged in (called `homeLanding` by MB) | [See example screenshot](https://gitlab.com/mbcp/info/-/wikis/uploads/4648fd3e4caa9f30092af377485c2d15/image.png)
+
+- `coreBanking_img_successBackground.png` are present on successful transfer screen | [See example screenshot](https://gitlab.com/mbcp/info/-/wikis/uploads/e01db5c3801a01499a705c1bfe1f7eab/image.png)
+
+- `general_bg_screenshot.png` are present on saved successful transfer screen (Save photo function) | [See screenshot example](https://gitlab.com/mbcp/info/-/wikis/uploads/25df9102faad338a0376ed0bd1985981/image.png)
+
+- `qr_img_ThemeDefalut.png` are present on QR receive screen page | [See example screenshot](https://gitlab.com/mbcp/info/-/wikis/uploads/629a7fd3ec9fe619f87ed7034e358695/image.png)
+
+- `eMBee_img_header.png` used to be eMBee logo on bottom app navigation, but it's now unused since `v6.4.53+`
+
+- `general_bg_success.png` might present on some screen, like payment for bill electric (idk)
+
+If you want to made Magisk Module that contain your theme, [follow this template module](https://git.disroot.org/mbcp/tweaked-mbflutter-themes/src/branch/main/community_themes/template)