Update README and CHANGELOG
This commit is contained in:
parent
9f01d9cb12
commit
b6b0857f17
7 changed files with 77 additions and 53 deletions
BIN
.github/apps.png
vendored
Normal file
BIN
.github/apps.png
vendored
Normal file
Binary file not shown.
After Width: | Height: | Size: 104 KiB |
BIN
.github/bookmarks.png
vendored
Normal file
BIN
.github/bookmarks.png
vendored
Normal file
Binary file not shown.
After Width: | Height: | Size: 105 KiB |
BIN
.github/home.png
vendored
Normal file
BIN
.github/home.png
vendored
Normal file
Binary file not shown.
After Width: | Height: | Size: 101 KiB |
BIN
.github/settings.png
vendored
Normal file
BIN
.github/settings.png
vendored
Normal file
Binary file not shown.
After Width: | Height: | Size: 62 KiB |
27
CHANGELOG.md
27
CHANGELOG.md
|
@ -1,3 +1,16 @@
|
||||||
|
### v2.0.0 (TBA)
|
||||||
|
- Added authentication system:
|
||||||
|
- Only logged in user can access settings ([#33](https://github.com/pawelmalak/flame/issues/33))
|
||||||
|
- User can set which apps, categories and bookmarks should be available for guest users ([#45](https://github.com/pawelmalak/flame/issues/45))
|
||||||
|
- Visit [project wiki](https://github.com/pawelmalak/flame/wiki/Authentication) to read more about this feature
|
||||||
|
- Docker images will now be versioned ([#110](https://github.com/pawelmalak/flame/issues/110))
|
||||||
|
- Icons can now be set via URL ([#138](https://github.com/pawelmalak/flame/issues/138))
|
||||||
|
- Added current time to the header ([#157](https://github.com/pawelmalak/flame/issues/157))
|
||||||
|
- Fixed bug where typing certain characters in the search bar would result in a blank page ([#158](https://github.com/pawelmalak/flame/issues/158))
|
||||||
|
- Fixed bug with MDI icon name not being properly parsed if there was leading or trailing whitespace ([#164](https://github.com/pawelmalak/flame/issues/164))
|
||||||
|
- Added Wikipedia to search queries
|
||||||
|
- Lots of changes and refactors under the hood to make future development easier
|
||||||
|
|
||||||
### v1.7.4 (2021-11-08)
|
### v1.7.4 (2021-11-08)
|
||||||
- Added option to set custom greetings and date ([#103](https://github.com/pawelmalak/flame/issues/103))
|
- Added option to set custom greetings and date ([#103](https://github.com/pawelmalak/flame/issues/103))
|
||||||
- Fallback to web search if local search has zero results ([#129](https://github.com/pawelmalak/flame/issues/129))
|
- Fallback to web search if local search has zero results ([#129](https://github.com/pawelmalak/flame/issues/129))
|
||||||
|
@ -62,12 +75,12 @@
|
||||||
- Fixed custom icons not updating ([#58](https://github.com/pawelmalak/flame/issues/58))
|
- Fixed custom icons not updating ([#58](https://github.com/pawelmalak/flame/issues/58))
|
||||||
- Added changelog file
|
- Added changelog file
|
||||||
|
|
||||||
### v1.6 (2021-07-17)
|
### v1.6.0 (2021-07-17)
|
||||||
- Added support for Steam URLs ([#62](https://github.com/pawelmalak/flame/issues/62))
|
- Added support for Steam URLs ([#62](https://github.com/pawelmalak/flame/issues/62))
|
||||||
- Fixed bug with custom CSS not persisting ([#64](https://github.com/pawelmalak/flame/issues/64))
|
- Fixed bug with custom CSS not persisting ([#64](https://github.com/pawelmalak/flame/issues/64))
|
||||||
- Added option to set default prefix for search bar ([#65](https://github.com/pawelmalak/flame/issues/65))
|
- Added option to set default prefix for search bar ([#65](https://github.com/pawelmalak/flame/issues/65))
|
||||||
|
|
||||||
### v1.5 (2021-06-24)
|
### v1.5.0 (2021-06-24)
|
||||||
- Added ability to set custom CSS from settings ([#8](https://github.com/pawelmalak/flame/issues/8) and [#17](https://github.com/pawelmalak/flame/issues/17)) (experimental)
|
- Added ability to set custom CSS from settings ([#8](https://github.com/pawelmalak/flame/issues/8) and [#17](https://github.com/pawelmalak/flame/issues/17)) (experimental)
|
||||||
- Added option to upload custom icons ([#12](https://github.com/pawelmalak/flame/issues/12))
|
- Added option to upload custom icons ([#12](https://github.com/pawelmalak/flame/issues/12))
|
||||||
- Added option to open links in a new or the same tab ([#27](https://github.com/pawelmalak/flame/issues/27))
|
- Added option to open links in a new or the same tab ([#27](https://github.com/pawelmalak/flame/issues/27))
|
||||||
|
@ -75,7 +88,7 @@
|
||||||
- Added option to hide applications and categories ([#48](https://github.com/pawelmalak/flame/issues/48))
|
- Added option to hide applications and categories ([#48](https://github.com/pawelmalak/flame/issues/48))
|
||||||
- Improved Logger
|
- Improved Logger
|
||||||
|
|
||||||
### v1.4 (2021-06-18)
|
### v1.4.0 (2021-06-18)
|
||||||
- Added more sorting options. User can now choose to sort apps and categories by name, creation time or to use custom order ([#13](https://github.com/pawelmalak/flame/issues/13))
|
- Added more sorting options. User can now choose to sort apps and categories by name, creation time or to use custom order ([#13](https://github.com/pawelmalak/flame/issues/13))
|
||||||
- Added reordering functionality. User can now set custom order for apps and categories from their 'edit tables' ([#13](https://github.com/pawelmalak/flame/issues/13))
|
- Added reordering functionality. User can now set custom order for apps and categories from their 'edit tables' ([#13](https://github.com/pawelmalak/flame/issues/13))
|
||||||
- Changed get all controllers for applications and categories to use case-insensitive ordering ([#36](https://github.com/pawelmalak/flame/issues/36))
|
- Changed get all controllers for applications and categories to use case-insensitive ordering ([#36](https://github.com/pawelmalak/flame/issues/36))
|
||||||
|
@ -84,14 +97,14 @@
|
||||||
- Added update check on app start ([#38](https://github.com/pawelmalak/flame/issues/38))
|
- Added update check on app start ([#38](https://github.com/pawelmalak/flame/issues/38))
|
||||||
- Fixed bug with decimal input values in Safari browser ([#40](https://github.com/pawelmalak/flame/issues/40))
|
- Fixed bug with decimal input values in Safari browser ([#40](https://github.com/pawelmalak/flame/issues/40))
|
||||||
|
|
||||||
### v1.3 (2021-06-14)
|
### v1.3.0 (2021-06-14)
|
||||||
- Added reverse proxy support ([#23](https://github.com/pawelmalak/flame/issues/23) and [#24](https://github.com/pawelmalak/flame/issues/24))
|
- Added reverse proxy support ([#23](https://github.com/pawelmalak/flame/issues/23) and [#24](https://github.com/pawelmalak/flame/issues/24))
|
||||||
- Added support for more url formats ([#26](https://github.com/pawelmalak/flame/issues/26))
|
- Added support for more url formats ([#26](https://github.com/pawelmalak/flame/issues/26))
|
||||||
- Added ability to hide main header ([#28](https://github.com/pawelmalak/flame/issues/28))
|
- Added ability to hide main header ([#28](https://github.com/pawelmalak/flame/issues/28))
|
||||||
- Fixed settings not being synchronized ([#29](https://github.com/pawelmalak/flame/issues/29))
|
- Fixed settings not being synchronized ([#29](https://github.com/pawelmalak/flame/issues/29))
|
||||||
- Added auto-refresh for greeting and date ([#34](https://github.com/pawelmalak/flame/issues/34))
|
- Added auto-refresh for greeting and date ([#34](https://github.com/pawelmalak/flame/issues/34))
|
||||||
|
|
||||||
### v1.2 (2021-06-10)
|
### v1.2.0 (2021-06-10)
|
||||||
- Added simple check to the weather module settings to inform user if the api key is missing ([#2](https://github.com/pawelmalak/flame/issues/2))
|
- Added simple check to the weather module settings to inform user if the api key is missing ([#2](https://github.com/pawelmalak/flame/issues/2))
|
||||||
- Added ability to set optional icons to the bookmarks ([#7](https://github.com/pawelmalak/flame/issues/7))
|
- Added ability to set optional icons to the bookmarks ([#7](https://github.com/pawelmalak/flame/issues/7))
|
||||||
- Added option to pin new applications and categories to the homescreen by default ([#11](https://github.com/pawelmalak/flame/issues/11))
|
- Added option to pin new applications and categories to the homescreen by default ([#11](https://github.com/pawelmalak/flame/issues/11))
|
||||||
|
@ -100,11 +113,11 @@
|
||||||
- Added proxy for websocket instead of using hard coded host ([#18](https://github.com/pawelmalak/flame/issues/18))
|
- Added proxy for websocket instead of using hard coded host ([#18](https://github.com/pawelmalak/flame/issues/18))
|
||||||
- Fixed bug with overwriting opened tabs ([#20](https://github.com/pawelmalak/flame/issues/20))
|
- Fixed bug with overwriting opened tabs ([#20](https://github.com/pawelmalak/flame/issues/20))
|
||||||
|
|
||||||
### v1.1 (2021-06-09)
|
### v1.1.0 (2021-06-09)
|
||||||
- Added custom favicon and changed page title ([#3](https://github.com/pawelmalak/flame/issues/3))
|
- Added custom favicon and changed page title ([#3](https://github.com/pawelmalak/flame/issues/3))
|
||||||
- Added functionality to set custom page title ([#3](https://github.com/pawelmalak/flame/issues/3))
|
- Added functionality to set custom page title ([#3](https://github.com/pawelmalak/flame/issues/3))
|
||||||
- Changed messages on the homescreen when there are apps/bookmarks created but not pinned to the homescreen ([#4](https://github.com/pawelmalak/flame/issues/4))
|
- Changed messages on the homescreen when there are apps/bookmarks created but not pinned to the homescreen ([#4](https://github.com/pawelmalak/flame/issues/4))
|
||||||
- Added 'warnings' to apps and bookmarks forms about supported url formats ([#5](https://github.com/pawelmalak/flame/issues/5))
|
- Added 'warnings' to apps and bookmarks forms about supported url formats ([#5](https://github.com/pawelmalak/flame/issues/5))
|
||||||
|
|
||||||
### v1.0 (2021-06-08)
|
### v1.0.0 (2021-06-08)
|
||||||
Initial release of Flame - self-hosted startpage using Node.js on backend and React on frontend.
|
Initial release of Flame - self-hosted startpage using Node.js on backend and React on frontend.
|
||||||
|
|
93
README.md
93
README.md
|
@ -1,37 +1,25 @@
|
||||||
# Flame
|
# Flame
|
||||||
|
|
||||||
![Homescreen screenshot](./.github/_home.png)
|
![Homescreen screenshot](.github/home.png)
|
||||||
|
|
||||||
## Description
|
## Description
|
||||||
|
|
||||||
Flame is self-hosted startpage for your server. Its design is inspired (heavily) by [SUI](https://github.com/jeroenpardon/sui). Flame is very easy to setup and use. With built-in editors, it allows you to setup your very own application hub in no time - no file editing necessary.
|
Flame is self-hosted startpage for your server. Its design is inspired (heavily) by [SUI](https://github.com/jeroenpardon/sui). Flame is very easy to setup and use. With built-in editors, it allows you to setup your very own application hub in no time - no file editing necessary.
|
||||||
|
|
||||||
## Technology
|
## Functionality
|
||||||
|
📝 Create, update, delete your applications and bookmarks directly from the app using built-in GUI editors
|
||||||
|
|
||||||
- Backend
|
📌 Pin your favorite items to the homescreen for quick and easy access
|
||||||
- Node.js + Express
|
|
||||||
- Sequelize ORM + SQLite
|
|
||||||
- Frontend
|
|
||||||
- React
|
|
||||||
- Redux
|
|
||||||
- TypeScript
|
|
||||||
- Deployment
|
|
||||||
- Docker
|
|
||||||
- Kubernetes
|
|
||||||
|
|
||||||
## Development
|
🔍 Integrated search bar with local filtering, 11 web search providers and ability to add your own
|
||||||
|
|
||||||
```sh
|
🔑 Authentication system to protect your settings, apps and bookmarks
|
||||||
# clone repository
|
|
||||||
git clone https://github.com/pawelmalak/flame
|
|
||||||
cd flame
|
|
||||||
|
|
||||||
# run only once
|
🔨 Dozens of option to customize Flame interface to your needs, including support for custom CSS and 15 built-in color themes
|
||||||
npm run dev-init
|
|
||||||
|
☀️ Weather widget with current temperature, cloud coverage and animated weather status
|
||||||
|
|
||||||
# start backend and frontend development servers
|
🐳 Docker integration to automatically pick and add apps based on their labels
|
||||||
npm run dev
|
|
||||||
```
|
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
|
@ -40,24 +28,26 @@ npm run dev
|
||||||
[Docker Hub link](https://hub.docker.com/r/pawelmalak/flame)
|
[Docker Hub link](https://hub.docker.com/r/pawelmalak/flame)
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
docker pull pawelmalak/flame:latest
|
docker pull pawelmalak/flame
|
||||||
|
|
||||||
# for ARM architecture (e.g. RaspberryPi)
|
# for ARM architecture (e.g. RaspberryPi)
|
||||||
docker pull pawelmalak/flame:multiarch
|
docker pull pawelmalak/flame:multiarch
|
||||||
```
|
|
||||||
|
|
||||||
|
# installing specific version
|
||||||
|
docker pull pawelmalak/flame:2.0.0
|
||||||
|
```
|
||||||
|
|
||||||
#### Building images
|
#### Building images
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
# build image for amd64 only
|
# build image for amd64 only
|
||||||
docker build -t flame .
|
docker build -t flame -f .docker/Dockerfile .
|
||||||
|
|
||||||
# build multiarch image for amd64, armv7 and arm64
|
# build multiarch image for amd64, armv7 and arm64
|
||||||
# building failed multiple times with 2GB memory usage limit so you might want to increase it
|
# building failed multiple times with 2GB memory usage limit so you might want to increase it
|
||||||
docker buildx build \
|
docker buildx build \
|
||||||
--platform linux/arm/v7,linux/arm64,linux/amd64 \
|
--platform linux/arm/v7,linux/arm64,linux/amd64 \
|
||||||
-f Dockerfile.multiarch \
|
-f .docker/Dockerfile.multiarch \
|
||||||
-t flame:multiarch .
|
-t flame:multiarch .
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -81,6 +71,8 @@ services:
|
||||||
- /var/run/docker.sock:/var/run/docker.sock # optional but required for Docker integration feature
|
- /var/run/docker.sock:/var/run/docker.sock # optional but required for Docker integration feature
|
||||||
ports:
|
ports:
|
||||||
- 5005:5005
|
- 5005:5005
|
||||||
|
environment:
|
||||||
|
- PASSWORD=flame_password
|
||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -95,32 +87,51 @@ skaffold dev
|
||||||
|
|
||||||
Follow instructions from wiki: [Installation without Docker](https://github.com/pawelmalak/flame/wiki/Installation-without-docker)
|
Follow instructions from wiki: [Installation without Docker](https://github.com/pawelmalak/flame/wiki/Installation-without-docker)
|
||||||
|
|
||||||
## Functionality
|
## Development
|
||||||
|
|
||||||
- Applications
|
### Technology
|
||||||
- Create, update, delete and organize applications using GUI
|
|
||||||
- Pin your favourite apps to the homescreen
|
|
||||||
|
|
||||||
![Homescreen screenshot](./.github/_apps.png)
|
- Backend
|
||||||
|
- Node.js + Express
|
||||||
|
- Sequelize ORM + SQLite
|
||||||
|
- Frontend
|
||||||
|
- React
|
||||||
|
- Redux
|
||||||
|
- TypeScript
|
||||||
|
- Deployment
|
||||||
|
- Docker
|
||||||
|
- Kubernetes
|
||||||
|
|
||||||
- Bookmarks
|
### Creating dev environment
|
||||||
- Create, update, delete and organize bookmarks and categories using GUI
|
|
||||||
- Pin your favourite categories to the homescreen
|
|
||||||
- Import html bookmarks (experimental)
|
|
||||||
|
|
||||||
![Homescreen screenshot](./.github/_bookmarks.png)
|
```sh
|
||||||
|
# clone repository
|
||||||
|
git clone https://github.com/pawelmalak/flame
|
||||||
|
cd flame
|
||||||
|
|
||||||
- Weather
|
# run only once
|
||||||
|
npm run dev-init
|
||||||
|
|
||||||
- Get current temperature, cloud coverage and weather status with animated icons
|
# start backend and frontend development servers
|
||||||
|
npm run dev
|
||||||
|
```
|
||||||
|
|
||||||
- Themes
|
## Screenshots
|
||||||
- Customize your page by choosing from 15 color themes
|
|
||||||
|
|
||||||
![Homescreen screenshot](./.github/_themes.png)
|
![Apps screenshot](.github/apps.png)
|
||||||
|
|
||||||
|
![Bookmarks screenshot](.github/bookmarks.png)
|
||||||
|
|
||||||
|
![Settings screenshot](.github/settings.png)
|
||||||
|
|
||||||
|
![Themes screenshot](.github/_themes.png)
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
|
### Authentication
|
||||||
|
|
||||||
|
Visit [project wiki](https://github.com/pawelmalak/flame/wiki/Authentication) to read more about authentication
|
||||||
|
|
||||||
### Search bar
|
### Search bar
|
||||||
|
|
||||||
#### Searching
|
#### Searching
|
||||||
|
|
|
@ -50,15 +50,15 @@
|
||||||
"prefix": "td",
|
"prefix": "td",
|
||||||
"template": "https://listen.tidal.com/search?q="
|
"template": "https://listen.tidal.com/search?q="
|
||||||
},
|
},
|
||||||
{
|
|
||||||
"name": "YouTube",
|
|
||||||
"prefix": "yt",
|
|
||||||
"template": "https://www.youtube.com/results?search_query="
|
|
||||||
},
|
|
||||||
{
|
{
|
||||||
"name": "Wikipedia",
|
"name": "Wikipedia",
|
||||||
"prefix": "w",
|
"prefix": "w",
|
||||||
"template": "https://en.wikipedia.org/w/index.php?search="
|
"template": "https://en.wikipedia.org/w/index.php?search="
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"name": "YouTube",
|
||||||
|
"prefix": "yt",
|
||||||
|
"template": "https://www.youtube.com/results?search_query="
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
|
|
Loading…
Reference in a new issue