Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ndonkohenri/flet-color-browser

A simple Web and desktop UI for easy color selection in Flet Application development.
https://github.com/ndonkohenri/flet-color-browser

color-palette color-picker flet flet-dev pwa python3 webapp

Last synced: about 1 month ago
JSON representation

A simple Web and desktop UI for easy color selection in Flet Application development.

Awesome Lists containing this project

README

        

# Flet-Color-Browser

![AppVeyor](https://img.shields.io/appveyor/build/ndonkoHenri/flet-color-browser)
![Platform](https://img.shields.io/badge/platform-browser%20%7C%20PWA%20%7C%20windows%20%7C%20macos%20%7C%20linux-lightgrey)
![GitHub top language](https://img.shields.io/github/languages/top/ndonkoHenri/Flet-Color-Browser)
![GitHub language count](https://img.shields.io/github/languages/count/ndonkoHenri/Flet-Color-Browser)
![GitHub repo file count](https://img.shields.io/github/directory-file-count/ndonkoHenri/Flet-Color-Browser?color=ry)

> _From my experience, working with colors is not that easy._
## Table of contents:
- [Introduction](#what-is-this-about-introduction)
- [Source of Inspiration](#source-of-inspiration)
- [Screen captures](#screen-captures)
- [How to get started?](#how-to-get-started)
- [How to deploy?](#how-to-deploy)
- [Issues/Contribution](#issuescontribution)

### What is this about? (Introduction)

A simple but sophisticated tool(Web and desktop UI) for easy color selection when developing [Flet](https://flet.dev/) applications.
Here is a link to the online/web version of this tool -> [flet-colors-browser.fly.dev](https://flet-colors-browser.fly.dev/)

### Source of Inspiration

I decided to build up this tool after looking at the [Flet-Icons-Browser](https://github.com/flet-dev/examples/tree/main/python/apps/icons-browser) - a simple browser which eases Icon selection when developing Flet apps .
This tool is actually a refactored-clone(or fork if you want) of it.
I just added my personal UI touch and included more comments in the code :)

### Screen captures
This tool has two versions: One using a [GridView](https://flet.dev/docs/controls/gridview) to display the colors, and another using a [ListView](https://flet.dev/docs/controls/listview) in [Tabs](https://flet.dev/docs/controls/tabs).

Below are some OLD captures I made of the tool in execution.

- _**Version 1:**_
- _Dark Mode_



![V1 Dark Mode](https://user-images.githubusercontent.com/98978078/193250212-a56477ac-f063-4b45-99e3-7dbb971eee27.JPG)



- _Light Mode_



![V1 Light Mode](https://user-images.githubusercontent.com/98978078/193256037-2ee24033-425f-4c9e-958a-f20e3c207917.JPG)

- _**Version 2:**_
- _Dark Mode_



![V2 Light Mode](https://user-images.githubusercontent.com/98978078/193249865-b626c155-7dc3-4188-9fc7-e7a163357c5d.JPG)




- _Light Mode_



![Capture](https://user-images.githubusercontent.com/98978078/193256644-3cf3dec8-ca52-4a6e-a772-f567074891f5.JPG)



- **GIF Video**



![Colors-Browser GIF](https://user-images.githubusercontent.com/98978078/193254404-bef6c113-b71d-4e01-b732-cd5d268619ec.gif)

### How to get started?

**Easiest Way:** You can [open it on your browser](https://flet-colors-browser.fly.dev/) and install it as a PWA(Progressive Web Application). It would then be found on your desktop(Windows, macOS, Linux.. etc), and you could run it any time. Follow the guide below gotten from a [Post on Medium](https://medium.com/@dhormale/install-pwa-on-windows-desktop-via-google-chrome-browser-6907c01eebe4).

![How to Install as PWA](https://miro.medium.com/max/720/1*BQ5FlcpuLTOBfF5vLvv6Bg.gif)

**Second-Easiest Way:**
- Try the app online from here:
- You can just download an archive(for Windows, macOS and Linux only) from the [releases](https://github.com/ndonkoHenri/Flet-Color-Browser/releases) section, extract this and run the standalone executable file(~25Mo) found in it.

**Hardest Way:**
- Start by cloning and unzipping this repo: [how-to](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository)
- Enter the directory

cd Flet-Color-Browser
- Install the requirements:
`pip install requirements.txt -r`
- Run the `main.py` file

python main.py

### How to Deploy?
See [this](https://ndonkohenri.medium.com/deploying-a-flet-app-for-free-on-cloudflare-pages-e56ecc6ce450) article to deploy this flet app and all others you have for freeee.

### Issues/Contribution
I tried my best to make this project simple and easy to understand, but if you have problems/issues while using this :(,
then you are free to raise an issue and I will happily respond.

If you instead want to contribute(new features, bug/typo fixes, etc), just fork this project and make a pull request. :)