Skip to content

elementary/appcenter-web

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.

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:

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:

gem install jekyll bundler

Install gems:

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, run:

ruby generate-flatpak.rb

This is automatically run hourly with a GitHub Action workflow.

Serve

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 for the original script and Ryan McNeely for the initial Flatpak port!