Welcome to Over The Hill - Documentation

A web and desktop application designed to visualize project progress using Hill Charts

Fast & Lightweight

Built with Hugo for lightning-fast performance and minimal resource usage.

Easy Navigation

Clean sidebar navigation with organized sections for better content discovery.

Responsive Design

Mobile-first design that looks great on all devices and screen sizes.


Inspired by 37signals

Hill Charts are a great way to visually communicate progress and incoming work.

Read Shape Up: Show Porgress (Chapt. 13) to discover the technique.

What is Over The Hill?

Over The Hill is a web and desktop application designed to visualize project progress using a “Hill Chart.” A Hill Chart is a simple yet powerful tool for tracking the status of tasks or features, categorizing them into two main phases: “Up the Hill” (discovery/problem-solving) and “Down the Hill” (execution/implementation).

This app allows you to:

  • Create and manage “dots”: Each dot represents a task, feature, or item you want to track.

  • Position dots on the hill: Drag and drop dots to indicate their progress. Dots on the left side are “Up the Hill” (still figuring things out), and dots on the right side are “Down the Hill” (known work, being executed).

  • Customize dots: Assign names, colors (blue, green, red, orange, purple), and sizes (1-5) to each dot for better categorization and visual distinction.

  • Organize with collections: Group related dots into collections to manage multiple projects or different aspects of a single project.

  • Export your chart: Copy the generated hill chart as a PNG image or an SVG file to your clipboard, or download it as a PNG file, for easy sharing and documentation.

  • Theme support: Switch between light, dark, or system-preferred themes for a comfortable viewing experience.

How to Use

  1. Add Dots: Click the “Add Dot” button to create a new task or item.

  2. Name and Customize: In the dot editing panel, give your dot a name, and select its color and size using the dropdowns.

  3. Position on the Hill: Drag the dot on the hill chart to reflect its current status.

  • Up the Hill (Left Side): For tasks where you’re still exploring, researching, or solving problems.

  • Down the Hill (Right Side): For tasks where the path is clear, and you’re actively implementing.

  1. Manage Collections: Use the “Collections” dropdown to create new collections, switch between them, or manage existing ones.

  2. Export/Share:

  • Click the ellipsis menu (...) in the top right corner.

  • Under “Export Clipboard Format,” choose “Copy as PNG” or “Copy as SVG” to set the clipboard format.

  • Click the “Copy” button in the chart header to copy the chart to your clipboard in the selected format.

  • Click the “Download PNG” button to save the chart as a PNG file to your system.

  1. Theme Switching: Use the ellipsis menu (...) to toggle between “Light,” “Dark,” or “Follow Browser” themes.

Demo

Try it out live at:

https://over-the-hill.faurobert.fr/

Documentation

Check our documentation on gfaurobert.github.io/over-the-hill/

Recent Content

Getting Started

So you’re ready to generate a Hill Chart for a project?

First, if you are on Windows or macOS use the following dedicated guides:

  • Download and Install the Desktop App (Windows) - Coming Soon
  • Download and Install the Desktop App (macOS) - Coming Soon

Download the latest release

Run the App Image

  • Once downloaded, execute the App Image

If the app doesn’t launch or is blank (like shown below)

Read more →

Self-Hosting Guide (Ubuntu)

1. Prerequisites

  • Ubuntu server (tested on 20.04/22.04)
  • Root or sudo access
  • Domain name (optional, for HTTPS)

Install Required Packages

sudo apt update
sudo apt install -y git curl build-essential

Install Node.js (LTS) & pnpm

# Install Node.js (replace 20.x with latest LTS if needed)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# Install pnpm globally
npm install -g pnpm

2. Clone the Repository

git clone https://github.com/gfaurobert/over-the-hill.git && cd over-the-hill

3. Install Dependencies

pnpm install

4. Build the App

pnpm build

5. Run the App in Production

Install pm2 (Process Manager)

npm install -g pm2

Start the App

pm2 start "pnpm start" --name over-the-hill

(Optional) Save pm2 Process List & Enable Startup on Boot

pm2 save
pm2 startup
# Follow the printed instructions to enable pm2 on boot

Check if Port 3000 is in Use

By default, Next.js runs on port 3000. To check if something is already using this port:

Read more →