/awwesome

Enhanced user interface for Awesome Selfhosted

Primary LanguageTypeScriptBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Awwesome

Enhanced user interface for Awesome Selfhosted

Visit awweso.me for a demo

Original data by the awesome-selfhosted community, licensed under CC-BY-SA 3.0

awwesome_screenshot

Technology

This projects uses Svelte and Tailwind.

The projects are crawled from Awesome Selfhosted and then additional data is fetched from GitHubs GraphQL API.

Personal Access Token

You will need a personal access token from Github to be able to use the GraphQL API. More information on this can be found under "Managing your personal access tokens".

It is recommended to use a fine-grained personal access token without any access rights. This is possible because fine-grained personal access have access to public repos per default.

The personal access token needs to be added to a .env file in the root directory.

TOKEN_GITHUB=abcdefg.....

Developing

Clone the repository, install the dependencies and start the development server:

npm install
npm run dev

# or start the server and open the app in a new browser tab
npm run dev -- --open

Production

It is recommended to statically generate Awwesome instead of server render the site, because the GraphQL queries can take long and therefore reduce the user experience.

# generate a static build
npm run build

# preview the generated build in a local webserver
npm run preview