Startpage serves as a custom browser homepage with intelligent search routing:

• Enter full URLs to navigate directly to them
• Use custom shortcuts (e.g., mail -> Gmail, yt -> YouTube)
• Automatically fallback to Google search for unrecognized queries
• Lightweight and fast with minimal dependencies

• Go 1.23.0 or later
• templ (for template generation)
• Taskfile

To setup systemd service and sample config:

task deploy

and open localhost:1111 in the browser.

task build

Create a config file at ~/.config/startpage/config.yml to define your custom shortcuts. Or use sample config:

task build:config

config.yml example

The application uses port 1111 by default. You can override this with the PORT environment variable:

# Use default port (1111)
./bin/startpage

# Use custom port
PORT=8080 ./bin/startpage

# Development mode uses port 1110
DEV=1 ./bin/startpage

Port priority:

1. PORT environment variable (if set)
2. Port 1110 (if DEV environment variable is set)
3. Port 1111 (default)

task deploy:service

systemctl --user status startpage

journalctl --user -u startpage -f

By default service is set to restart on boot. To disable this behavior:

systemctl --user disable startpage

# Install templ
go get -tool github.com/a-h/templ/cmd/templ@latest

# Run in development mode with hot reload
task dev

This will start the application with automatic template regeneration and reload on port 1112 (proxying to port 1110).

1. Set your browser's homepage to http://localhost:1111 (or your configured port)
2. Type shortcuts (e.g., mail, yt) to navigate to configured URLs
3. Type full URLs to navigate directly
4. Type anything else to search on Google