https://github.com/garuda-linux/startpage-v2
New Garuda Linux general purpose startpage, built with Angular in Catppuccin style 🐈
https://github.com/garuda-linux/startpage-v2
angular catppuccin garuda-linux startpage
Last synced: 8 months ago
JSON representation
New Garuda Linux general purpose startpage, built with Angular in Catppuccin style 🐈
- Host: GitHub
- URL: https://github.com/garuda-linux/startpage-v2
- Owner: garuda-linux
- License: gpl-3.0
- Created: 2024-10-15T05:35:27.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-18T22:21:36.000Z (over 1 year ago)
- Last Synced: 2024-11-18T23:27:21.259Z (over 1 year ago)
- Topics: angular, catppuccin, garuda-linux, startpage
- Language: TypeScript
- Homepage: https://start.garudalinux.org
- Size: 10.3 MB
- Stars: 7
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-starred - garuda-linux/startpage-v2 - New Garuda Linux general purpose startpage, built with Angular in Catppuccin style 🐈 (mirrored from GitLab) (TypeScript)
README
# Garuda Startpage
This is Garuda's new startpage.
It is a simple page with a search bar and a few links to other pages.
The page is built with Angular + GarudaNG/PrimeNG.
## Changing static settings
To change the links, edit [config.ts](./config.ts) in the root directory.
- `contactLinks` is a list of links to contact pages.
- `defaultSettings` is the default settings for the page.
- `logos` and `logoList` control the logos shown above the search input.
- `serviceLinks` is a list of links to our web services.
- `SearchEngine` and `searchEngineMappings` to add or remove search engines from the list.
- `wallpapers` is a list of wallpapers to show on the settings page. `name` will be shown in the settings, `url` maybe a
local file relative to the `public` folder or a link to an image.
Additionally,
[jokes.ts](./src/app/jokes/jokes.ts) contains the list of developer excuses/jokes that will be shown on the main page.
## Get the tools
## Changing runtime (user facing) settings
The settings are stored in the local storage of the browser.
To change the settings, click on the settings icon in the top right corner of the page.
The following can be adjusted:
- Welcome message
- Name of the user
- The search engine (with custom search engines)
- Paste the search url in the search engine input field, e.g. `https://search.garudalinux.org/search?q=%s`
- The wallpaper
- Logo to show on the page (+ custom logo via link)
- Whether to fit or fill the wallpaper
- Blur the wallpaper
- Enable or disables developer excuses
- Show or hide default links
- Page title shown in the browser tab
- Custom links (via fully responsive table)
## Development
To get started with this workspace, you need to install the following tools:
- [NodeJs](https://nodejs.org/en/)
- [pnpm](https://pnpm.io/)
Install the deps with:
```sh
pnpm install
```
## Run tasks
To run the dev server for your app, use:
```sh
pnpm start
```
Visit [http://localhost:4200](http://localhost:4200) to see the app with live reload.
To create a production bundle:
```sh
pnpm build
```
To see all available targets to run for a project, run:
```sh
nx show project startpage-v3
```