OhEarningsCal

Subscribe to US stock earnings dates from your calendar app. This started as a tool I built for myself — I'd rather glance at my calendar than open a brokerage app — and turned out useful enough to open-source.

Just use it

Visit https://earnings.beavern.com/, pick a calendar, copy the link, then add it as a calendar subscription in your app of choice.

The calendars cover the US market only, in a rolling window of ±30 days around today (anything further out isn't accurate enough to matter).

Calendars

| File | Contents | | --- | --- | | all.ics | Every company that reports earnings in the window | | nasdaq100.ics | Nasdaq-100 constituents | | sp500.ics | S&P 500 constituents | | dow30.ics | Dow Jones Industrial Average constituents | | customstock.ics | A custom watchlist driven by the CUSTOM_STOCKS env var | | selected.ics | Union of the four above, deduplicated |

Self-hosting

1. Fork this repo
2. Settings → Pages → Source → switch to GitHub Actions
3. Settings → Secrets and variables → Actions → Variables → add:

1. Wait for the next scheduled run, or kick off Actions → Update earnings calendar → Run workflow manually.

Automation

| Workflow | Schedule | What it does | | --- | --- | --- | | earnings.yml | Daily 04:34 / 16:34 UTC | Fetch earnings → build ics → deploy to GitHub Pages | | indices.yml | Mondays 06:17 UTC | Refresh index constituents from Wikipedia, commit data/indices/ |

Earnings data is cached in GitHub Actions cache, never in git — main only carries source code and the index constituents.

Local development

pnpm install
cp .env.example .env   # edit env vars
pnpm fetch:indices     # first run / when refreshing constituents
pnpm fetch             # pull yesterday + next 30 days into data/earnings/
pnpm gen               # write docs/ics/*.ics
pnpm dev               # http://localhost:18302

Convenience endpoints on the dev server:

• GET /dev/fetch — trigger one fetch
• GET /dev/fetch-indices — trigger one fetch:indices
• GET /dev/gen — trigger one gen

Layout

src/
├── lib/        # shared helpers (date, paths, http, fs)
├── config/     # env parsing, index metadata
├── fetch/      # data sources: Nasdaq earnings, Wikipedia constituents
├── process/    # filter + dedupe earnings rows
├── generate/   # build .ics files
├── cli/        # entrypoints (fetch / fetch-indices / gen)
└── server.js   # local dev server
data/
├── earnings/   # daily JSON cache (gitignored, GH Actions cache between runs)
└── indices/    # index constituents, refreshed weekly (in git)
docs/
├── index.html  # static landing page
├── CNAME
└── ics/        # generated .ics files (gitignored, written by build)