https://github.com/elementary/appcenter-web
Web frontend for viewing AppCenter apps
https://github.com/elementary/appcenter-web
appstream github-pages hacktoberfest jekyll
Last synced: 5 months ago
JSON representation
Web frontend for viewing AppCenter apps
- Host: GitHub
- URL: https://github.com/elementary/appcenter-web
- Owner: elementary
- License: unlicense
- Created: 2016-07-07T01:23:35.000Z (over 9 years ago)
- Default Branch: main
- Last Pushed: 2025-06-29T02:44:58.000Z (8 months ago)
- Last Synced: 2025-06-29T03:43:09.462Z (8 months ago)
- Topics: appstream, github-pages, hacktoberfest, jekyll
- Language: HTML
- Homepage: https://appcenter.elementary.io
- Size: 27.3 MB
- Stars: 45
- Watchers: 8
- Forks: 11
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AppCenter Web
Web frontend for viewing AppCenter apps for elementary OS.
## Building
AppCenter Web is a simple Jekyll-powered site hosted by GitHub Pages. To run it locally, see [the GitHub docs](https://help.github.com/articles/setting-up-your-github-pages-site-locally-with-jekyll/).
### Dependencies
This guide assumes you're on elementary OS or a similar Ubuntu-based environment.
#### Packages
- `ruby-full` (should include `ruby` and `ruby-dev`)
- `build-essential`
- `zlib1g-dev`
#### Ruby Stuff
- `jekyll` and `bundler`
We recommend installing gems to a (hidden) directory in your home folder:
```shell
echo '' >> ~/.bashrc
echo '# Install Ruby Gems to ~/.gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/.gems"' >> ~/.bashrc
echo 'export PATH="$GEM_HOME/bin:$PATH"' >> ~/.bashrc
echo '' >> ~/.bashrc
source ~/.bashrc
```
Install jekyll and bundler:
```shell
gem install jekyll bundler
```
Install gems:
```shell
bundle install
```
(Adapted from https://jekyllrb.com/docs/installation/)
### Updating Apps
The list of apps is generated with a simple Ruby script. To rebuild the app list, delete the existing files so any removals (e.g. end-of-life apps) are reflected, then run the script:
```shell
rm _apps/*
ruby generate-flatpak.rb
```
This is automatically run hourly with a GitHub Action workflow.
### Serve
```shell
bundle exec jekyll serve --host 0.0.0.0
```
The site should now be available at http://0.0.0.0:4000/ on your local machine, and your local machine's IP address on your network—great for testing on mobile OSes.
## Thanks
Thanks to [@gamerlv](https://github.com/gamerlv) for [the original script](https://gist.github.com/gamerlv/4bb5e59415f239e8c79ff1d473e54520) and [Ryan McNeely](https://github.com/RMcNeely) for the [initial Flatpak port](https://github.com/elementary/appcenter-web/pull/58)!