explaingit

gavrielp1/salary-2045

★ 20HTMLAudience · pm founderComplexity · 2/5Setup · easy

TLDR

A self-hosted web app for tracking a dividend stock portfolio, showing income projections, dividend calendars, and progress toward a 2045 financial independence goal, no cloud, no subscription fees.

Mindmap

mindmap
  root((salary-2045))
    What it does
      Dividend portfolio tracker
      Passive income goal progress
      Dividend calendar
      Sector diversification charts
    Data sources
      yfinance free no key
      Alpha Vantage free API key
      90-day local cache
    Views
      Overview and progress bar
      Holdings detail
      Income history trends
      Per-stock deep dive
    Setup
      Clone and install Python
      Edit JSON config files
      Optional Docker install
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Track all your dividend stock holdings in one place and see your projected annual income at a glance

USE CASE 2

Monitor monthly dividend payment timing with a 12-month calendar to plan cash flow

USE CASE 3

Check how diversified your portfolio is across sectors with built-in charts

USE CASE 4

Set a passive income target and watch a progress bar show how close your dividends are to covering your living expenses

Tech stack

HTMLPythonyfinanceAlpha VantageDocker

Getting it running

Difficulty · easy Time to first run · 30min

Requires a free Alpha Vantage API key for fundamental data (25 requests/day limit), Docker on Linux not yet fully tested.

No license information is provided in the explanation.

In plain English

Salary 2045 is a self-hosted web app for tracking a dividend stock portfolio. Dividend investing means buying stocks that pay out a portion of their earnings to shareholders on a regular schedule, typically quarterly. The goal the project is built around is reaching a point where those dividend payments cover your living expenses, which the app targets for 2045. You run the app on your own computer and open it in a web browser at a local address. Nothing is sent to a cloud service, and there are no subscription fees. Your portfolio data, income goals, and any API keys are stored as plain JSON files on your machine that you edit by hand. The app has several views. The overview shows your total portfolio value, how much dividend income you expect annually, and a progress bar toward a passive income target you set yourself. The holdings view breaks down each stock position with its current price, how much it has gained or lost, the dividend yield, and a dividend safety score. Other screens show sector diversification charts, a month-by-month dividend calendar for the next 12 months, historical income trends, and a per-stock deep-dive with revenue, earnings, and payout history. Stock data is pulled from two sources: yfinance (free, no key required) and Alpha Vantage (free tier requires a free API key from their website, limited to 25 requests per day). The app caches fetched financial data locally for 90 days to stay within those limits. Setup involves cloning the repository, installing a handful of Python packages, copying a few example config files, entering your stock holdings as ticker symbols with share counts and your average purchase price, and running the app with one command. A Docker option is also included for those who prefer containerized installs, though the README notes Docker support on Linux is not yet fully tested.

Copy-paste prompts

Prompt 1
I cloned salary-2045 and have Python installed. Walk me through setting up the config files with my stock holdings as ticker symbols, share counts, and purchase prices, then running the app.
Prompt 2
How do I add my Alpha Vantage free API key to salary-2045 so I get fundamental data like revenue, earnings, and payout history for each stock?
Prompt 3
I want to run salary-2045 in Docker on Linux. Show me the docker-compose setup and any known issues with the Linux Docker support mentioned in the README.
Prompt 4
Using salary-2045 as a reference, explain how the dividend safety score is calculated for each stock and what data sources it draws from.
Prompt 5
How does salary-2045 cache yfinance and Alpha Vantage data locally for 90 days, and how do I force-refresh a specific ticker before the cache expires?
Open on GitHub → Explain another repo

← gavrielp1 on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.