{"id":13683268,"url":"https://github.com/PrettyCoffee/yet-another-generic-startpage","last_synced_at":"2025-04-30T12:34:17.778Z","repository":{"id":41432020,"uuid":"442512423","full_name":"PrettyCoffee/yet-another-generic-startpage","owner":"PrettyCoffee","description":"This a generic browser startpage.","archived":false,"fork":false,"pushed_at":"2023-08-04T22:50:42.000Z","size":3310,"stargazers_count":258,"open_issues_count":3,"forks_count":82,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-08-02T13:35:15.006Z","etag":null,"topics":["customizable","emotionjs","react","startpage"],"latest_commit_sha":null,"homepage":"https://prettycoffee.github.io/yet-another-generic-startpage/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PrettyCoffee.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-12-28T15:56:35.000Z","updated_at":"2024-08-01T14:17:55.000Z","dependencies_parsed_at":"2023-02-18T01:00:34.829Z","dependency_job_id":null,"html_url":"https://github.com/PrettyCoffee/yet-another-generic-startpage","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PrettyCoffee%2Fyet-another-generic-startpage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PrettyCoffee%2Fyet-another-generic-startpage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PrettyCoffee%2Fyet-another-generic-startpage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PrettyCoffee%2Fyet-another-generic-startpage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PrettyCoffee","download_url":"https://codeload.github.com/PrettyCoffee/yet-another-generic-startpage/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224212101,"owners_count":17274358,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["customizable","emotionjs","react","startpage"],"created_at":"2024-08-02T13:02:05.754Z","updated_at":"2024-11-12T03:30:48.741Z","avatar_url":"https://github.com/PrettyCoffee.png","language":"TypeScript","funding_links":[],"categories":["TypeScript","App Theming","Projects"],"sub_categories":["Firefox","GitHub Pages"],"readme":"# Yet another generic startpage\n\n![preview](./themes/preview.png)\n\nA startpage with a generic layout and many settings to modify the appearance.\n\n[Demo](https://prettycoffee.github.io/yet-another-generic-startpage/)\n\n## Usage\n\nThere are several options for using this startpage.\n\n### Fast setup\n\nThe easiest way to set it up is using the repositories demo with one of the many new tab override extensions like [this one for firefox](https://addons.mozilla.org/en-US/firefox/addon/new-tab-override/) or [this one for chrome](https://chrome.google.com/webstore/detail/new-tab-redirect/icpgjfneehieebagbmdbhnlpiopdcmna).\n\nInstall the extension and set `https://prettycoffee.github.io/yet-another-generic-startpage/` as new tab url.\n\n### Local Setup with Mini Yags\n\nYou can extract your startpage design into static files for local use by downloading a `Mini-YAGS` version.\n\nTo create a `Mini-YAGS` copy:\n\n1. Open the [Demo](https://prettycoffee.github.io/yet-another-generic-startpage/)\n2. Click on the arrows in the top right corner\n3. Design your startpage\n4. Scroll down to the `Mini-YAGS` section and click on `Zip me a copy!`\n5. Extract the files in the zip on your local system\n\nTo apply it for new tabs, install one of the the new tab override extensions and set `file:///C:/path/to/your/mini-yags/index.html` as new tab url.\n\n### Github Pages with Mini Yags\n\nRequired Knowledge: `git`, `github`\n\nYou can host your `Mini Yags` copy with github pages as well, to have it online. To do that, create your `Mini Yags` copy as explained before.\n\nThen follow these steps:\n\n1. Create a repository\n2. Push all the files of your `Mini Yags` copy into the repository, commit and push\n3. Open the repository settings on Github\n4. Open the `Pages` section from the navigation on the left hand side\n5. Select for `Source` -\u003e `Deploy from branch` and for `Branch` -\u003e `master` (or `main`) and `/(root)`\n6. Click on save\n\nThe startpage should now be hosted on github pages, it may take some minutes to finish the deployment. The url will be `\u003cuser-name\u003e.github.io/\u003crepo-name\u003e`.\n\nNote: This setup may change over time, if Github changes things, but the idea should stay the same.\n\n### Full startpage (no Mini Yags)\n\nRequired Knowledge: `git`, `github`, `npm`, `node`\n\nInstead of building a `Mini Yags` copy you can also host your own copy of the full startpage, including the settings window. This will allow you to customize the startpage later on.\n\nTo set it up with github pages:\n\n1. Fork the repository in github\n2. Clone it to your local machine\n3. Run `npm i` and `npm run build` in the project directory\n4. Deploy it on Github pages with one of the following methods:\n\n   - Use the deploy script:\n     1. Run `npm run deploy`, this will create a `gh-pages` and push the required files into the branch\n     2. Select the `gh-pages` branch as the source branch in the `pages` settings\n   - Make the setup manually:\n     1. Copy the files from the `/build` directory into a new branch\n     2. Push the branch to your repository\n     3. Select the branch as the source branch in the `pages` settings\n\n5. Use the github pages link (`\u003cuser-name\u003e.github.io/\u003crepo-name\u003e`) in the browser extension.\n\n### Others\n\nThere are several other options:\n\n- `Docker`: If you are familiar with Docker, a `Dockerfile` and `docker-compose.yml` are included in the repo.\n\n  ```\n  # build\n  $ docker build ./ -t yags\n\n  # run\n  $ docker run -d --name yags -p 8080:80 yags\n\n  # Alternative: Compose\n  $ docker compose up -d\n  ```\n\n- `Web extension`: You can set up the startpage as a web extension itself which would replace the installation of the extensions used above.\n- `Local nginx server`: Set up a local nginx server\n\n## Advanced: Modify code\n\nIf you want to modify something because the feature is missing, you can either create a `Mini Yags` copy and work with good old classic HTML/JS/CSS or you can fork the repo and change the `react` code.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPrettyCoffee%2Fyet-another-generic-startpage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FPrettyCoffee%2Fyet-another-generic-startpage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPrettyCoffee%2Fyet-another-generic-startpage/lists"}