Skip to content

Commit

Permalink
Document customization env vars
Browse files Browse the repository at this point in the history
  • Loading branch information
ArekSredzki committed Dec 20, 2022
1 parent 52a2223 commit d58dee1
Show file tree
Hide file tree
Showing 4 changed files with 15 additions and 3 deletions.
3 changes: 2 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ If you host your project on your Github **and** do not need a UI for your app, t
- Authenticates with LDAP, easy to modify to another authentication method if needed
- :sparkles: Store assets on server disk, or Amazon S3 (with minor modifications)
- Use pretty much any database for persistence, thanks to [Sails](http://sailsjs.org) & [Waterline](http://waterlinejs.org)
- :sparkles: Code-less [app customization through env variables](docs/customization.md)
- :sparkles: Simple but powerful download urls (**NOTE:** when no assets are uploaded, server returns `404` by default):
- `/download/latest`
- `/download/latest/:platform`
Expand Down Expand Up @@ -80,7 +81,7 @@ git rebase upstream/master
```

## Credit
This project has been built from the Sails.js up by Arek Sredzki, with inspiration from [nuts](https://github.com/GitbookIO/nuts).
This project has been built from Sails.js up by Arek Sredzki, with inspiration from [nuts](https://github.com/GitbookIO/nuts).

## License
[MIT License](LICENSE.md)
1 change: 1 addition & 0 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ There are questions that are asked quite often, [check this out before creating
- [Database setup](database.md)
- [Admin authentication](authentication.md)
- [Upload assets](assets.md)
- [Customization](customization.md)
- [Available URLs](urls.md)
- [OS X Auto-Updater](update-osx.md)
- [Windows Auto-Updater](update-windows.md)
Expand Down
4 changes: 2 additions & 2 deletions docs/api.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ This private API is used by the Admin UI & is authenticated through LDAP by defa
#### List versions:
```
GET http://download.myapp.com/api/version
GET http://download.myapp.com/versions/sorted
```

#### Get details about specific version:
Expand All @@ -23,5 +23,5 @@ PUT http://download.myapp.com/version/availability/1.1.0_default/1574755200000

#### List channels:
```
GET http://download.myapp.com/api/channel
GET http://download.myapp.com/channels/sorted
```
10 changes: 10 additions & 0 deletions docs/customization.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# Customization
Although this project is infinitely customizable through the process of forking the repo and making code changes, users that are satisfied with minimal branding can achieve this through environment variables.

The following environment variables can be set to customize the website:
- `WEBSITE_APP_TITLE`: The app name to use throughout the website.
- `WEBSITE_TITLE`: The title text to show on the home page and to use as the page title.
- `WEBSITE_HOME_CONTENT`: Content to display below the title on the home page.
- `WEBSITE_NAV_LOGO`: A url to a logo image that will be shown in place of the default Electron logo.

If you are deploying the app through `docker-compose`, then you can simply adjust these parameters in `docker-compose.yml`.

0 comments on commit d58dee1

Please sign in to comment.