Skip to content

custom-start-page/customstart.page

Repository files navigation

Choose a start page and start customising! These start pages were provided by the community and can be personalised to fit you best.

Screenshots

Homepage

Homepage

Settings page

Settings

About

This project aims to solve a problem - how can start pages be hosted and configured in a unified and friendly way?

Many people provide source code to their custom start pages but don't provide hosting or an intuitive way to customise the start page. Custom Start Page aims to solve that.

I built this project in my spare time and hope to continue supporting it, but updates are likely to be rare.

Features

  • a gallery of available start pages
  • hosting of start pages
  • using a form, customise the start page to your needs, things such as:
    • links
    • the background image
    • your name
    • the rss feed

Technology used

Getting started

You can check the ./Dockerfile for better information about running this application.

  1. Configure your hosts file to look something like this:
    127.0.0.1 customstart.local
    127.0.0.1 minimum-viable-startpage.customstart.local
    
  2. Edit the server/config.json file to have the domain name you chose in the hosts file
  3. Run npm start in the base directory
  4. Navigate to the domain you chose in the hosts file

Releasing/building

Read build.md.

Issues

Embedding the startpage with control from the outside

I want to be able to control certain parts of the startpage so I can:

  • control page meta information (title and meta description)
  • insert HTML messages for the user
  • track pageviews
  • allow editing from the startpage view?

Solutions:

Embed as iframe

Embed as custom element

  • HTML and JS works but can't seem to get CSS to work

Embed normally but with custom JS

  • requires startpage to include my JS (or maybe I can dynamically insert?)
  • CSS could collide with mine