Overview
Backyard is a self-hosted portfolio tracker for U.S. stocks, ETFs and crypto, and you get the full source code. A person types in what they own, pastes it from a spreadsheet, or records buys and sells. Backyard then shows what the portfolio is worth at today's prices, what moved, how it has done against the S&P 500, what dividends to expect, and total net worth. It never asks for a brokerage login. A chat called Ask Backyard answers plain questions such as "why did my portfolio move today?" from the person's own numbers.
It is a multi-user web app on Next.js with a single SQLite file, so it runs on one small server or Docker host. It suits developers who want a private tracker for themselves and their family, and operators who want to run a branded tracker for others. It is a tracker, not an advice tool: the chat filters out buy and sell recommendations and every answer is labelled "Not investment advice".
Features
Portfolio and holdings
- Overview dashboard: Portfolio value, today's change, gain so far and cash, a month chart from daily closes, the asset mix, your top movers and a one-line summary of the day.
- Holdings table: Every holding with quantity, last price, today's move, value and weight, grouped by account (taxable, Roth IRA, crypto and others).
- Transactions: Record purchases and sales with price, fees and date on each holding's page. Cost basis uses FIFO lots, and a card lists realized gains, split into under and over a year.
- Bulk import: Paste CSV, spreadsheet or plain-text rows. Columns are matched by header, and each bad row shows its own error while the rest are added.
- International tickers: Symbols listed outside the U.S. (such as SHOP.TO or VOD.L) keep their own currency and are converted to dollars with live FX rates.
- Sample portfolio: Start empty, or load a sample book to look around.
Ask Backyard chat
- Answers from your own data: Uses Anthropic Claude with read-only tools for the portfolio summary, holdings, income, goals, performance and headlines.
- Works without an AI key: Falls back to built-in rule-based answers when no key is set, the daily limit is reached, or the call fails.
- Cost and safety limits: A per-person daily message cap, and a filter that blocks replies that read as buy or sell advice.
- Everywhere in the app: A full chat page and a chat card on the dashboard. Press
A to open it.
Performance, income and net worth
- Performance: Time-weighted return over 1 month, 3 months, this year, 1 year or since you started, next to the S&P 500, with a "growth of 100" chart. Money added or withdrawn does not count as gain or loss.
- Dividend income: Expected income for the year, yield, and a 12-month bar chart of estimated payments with upcoming ex-dates, built from past payments.
- Net worth: Add things Backyard cannot price, such as a home, car or loan, and see a year-long net worth chart. Items not updated in a while are flagged.
- Goals: Set a target amount and date and see progress and the monthly amount needed, using a growth rate the person chooses.
- Target mix: Set a target split between asset types and see how far the portfolio has drifted.
Markets and news
- Markets page: Index cards with sparklines, tabs for stocks, crypto, futures, forex and bonds, 1D/1W/1M/1Y ranges, an 11-sector heatmap, stock movers (gainers, losers, most active, most volatile), a yield curve and upcoming earnings.
- On your radar: Your own holdings that moved most today, shown on the markets page.
- News: Top stories merged from several public RSS feeds (CNBC, The New York Times, Fortune, Nasdaq) with topic filters, plus a "your holdings" tab from per-stock feeds.
- Watchlist: Follow symbols you do not own yet.
Alerts and email
- Notices: A heads-up when a holding moves past a daily threshold you set.
- Alert rules: Per-symbol rules for a daily move, price above or price below. Each fires at most once a day.
- Weekly digest: A summary of last week's change and what moved it, on a digest page and by email.
- Delivery: Email through Resend or Postmark with a retrying outbox, browser push notifications (VAPID), and one-click unsubscribe.
Households
- Shared view: Create a household and invite a partner or family member by email. Members see a combined total.
- Opt-in sharing: A member's figures appear only if they choose to share. Anyone can leave, and the owner can remove members or dissolve the household.
Accounts and security
- Sign-up and sign-in: Email and password accounts with sessions stored in SQLite.
- Two-step sign-in: Authenticator app codes with recovery codes, a list of active sessions, and "sign out of other devices".
- Your data: Download holdings and transactions as CSV, or everything as a JSON backup, and delete the account.
- Rate limits: Configurable limits on sign-in, sign-up, quotes and import.
- Demo mode: An optional "Explore the demo" button that signs visitors into a shared sample account.
Staff desk
- Overview and activity: Live counts of people and books, the last quote source, and recent activity.
- People: Search, create and open accounts. Edit holdings, cash, goals, alerts and watchlist, set a new password, reset two-step sign-in, and pause or restore an account.
- Households and emails: Review households and the email outbox.
- Quote health: Ping the price cascade and read recent quote ticks.
- API keys: Paste Twelve Data, Finnhub, Anthropic, Resend, Postmark and push keys on the desk. They are stored encrypted and override environment variables.
- Exports: CSV exports of people, activity and emails.
Good to know
- There is no brokerage sync. Holdings are entered by hand, pasted, or recorded as transactions.
- Password reset is not self-service. The forgot-password page tells people to ask staff, who set a new password on the desk.
- Cash is counted at today's amount in performance and net worth charts. Cash history is not tracked.
- Dividend amounts and dates are estimates from past payments.
- The markets page, Yahoo price fallback, dividends and news use public, unofficial endpoints (Yahoo Finance charts and RSS feeds) that can change without notice. Company logos are fetched from public logo services and cached.
- Alerts, the email outbox and the weekly digest run when you call
/api/cron/<job> with a secret. You need to schedule those calls yourself, for example with system cron.
- The code uses the internal name "Cove" for its package and environment variables (
COVE_*).
Tech stack
- Next.js 16 (App Router), React 19, TypeScript, Tailwind CSS 4
- SQLite through better-sqlite3 and Drizzle ORM
- Anthropic SDK for Ask Backyard
- Recharts for charts, Lenis for landing-page scrolling
- web-push for browser notifications, qrcode for two-step sign-in setup
- Node test runner with tsx for unit tests
- Docker (Node 22)
What's included
- Full Next.js app: landing page, sign-up and sign-in, the tracker app, and the staff desk at
/admin
- 72 API routes covering holdings, transactions, quotes, markets, news, alerts, digests, households, security, exports and admin
- Database schema created automatically on first boot, with seeded staff and demo accounts for local use
- Production
Dockerfile that keeps the database on a /data volume
- Unit tests for the ledger, performance history, quotes, markets, news, logos, guards and more
.env.example documenting every supported setting
- README with local setup steps and seeded accounts
Requirements and third-party costs
You need Node 22 and a server or Docker host with a persistent disk for the SQLite file. No paid service is needed to start: with no keys set, prices fall back to Yahoo, and in development to bundled sample prices, and Ask Backyard uses its rule-based answers. Every key can be set in .env or pasted on the staff desk.
- Hosting (required): Any VPS or Docker host with a persistent volume. Serverless hosting is not a good fit because the database is a local file.
- Twelve Data (recommended): First choice for stock quotes. The free tier allows 8 quote credits per minute.
- Finnhub (recommended): Second price source, plus earnings and dividends. The free tier allows about 60 calls per minute.
- Anthropic Claude (optional): Powers the AI answers in Ask Backyard. Billed per token, with a per-person daily cap you set.
- Resend or Postmark (optional): Needed to send household invites, alert emails and the weekly digest.
- Web push (optional): Free. Generate VAPID keys with
npx web-push generate-vapid-keys.
- Yahoo Finance and news RSS feeds (no key): Public, unofficial endpoints used for markets data, dividends, the last price fallback and news. Check their terms before commercial use.
The purchase covers the source code only. Service fees are billed by the providers listed above.