Haruno Knowledge base

Portfolio and company pages

The Portfolio is the first screen of the Mac app. It shows every company whose books Haruno keeps, with a page for each company.

  • Mac appAvailable
  • Windows appAvailable

The Portfolio is what the Mac app opens on. It shows all your companies at once, so you can see which ones need a look. Press ⌘1 to come back to it from anywhere.

The Portfolio over the demo portfolio of ten made-up companies.
The Portfolio with six tiles across the top, a bar chart of cash by company, and the company list on the leftThe Portfolio with six tiles across the top, a bar chart of cash by company, and the company list on the left

What you see

Six tiles sit at the top of the page. They add up the whole portfolio.

TileWhat it tells you
CompaniesHow many companies, and the month of the latest close
Combined cashCash across all companies
Combined burnHow much cash the companies spend each month, added together
Under 12 mo runwayHow many companies would run out of cash within a year, and which ones. Runway is how many months the cash lasts at the recent rate of spending
Companies with findingsHow many companies have something the checks flagged, and how many reconciliation exceptions there are
Going-concern indicatorsWarning signs that a company may not be able to keep going

Under the tiles, Cash by company ranks the companies by cash. Below that, the companies are listed as cards or as a table.

Each card has a coloured dot. Red means the company is in trouble: it has a stated going-concern warning, or less than six months of runway. Orange means look at it: it has a serious finding, or less than twelve months of runway. Green means nothing stands out. Under the name, the card says why, in a few words.

A list of your companies also stays on the left. Click a name to open that company's page. You can drag the edge of the list to make it wider or narrower.

Cards or table

The toolbar has a Cards and Table switch. The tiles above it do not change. The table shows more columns, and you can sort by any of them. Click a heading again to reverse the order.

The same companies as a table.
The Portfolio as a table, one row per company, with columns for cash, burn, runway, findings and moreThe Portfolio as a table, one row per company, with columns for cash, burn, runway, findings and more

The sort button in the toolbar orders the cards by Name, Runway or Findings.

The toolbar

ControlWhat it does
Share buttonExport Portfolio Report… saves one report for the whole portfolio. See Reports and exports
Close month…Closes the month for the companies that are ready. See Closing a month
Plus buttonAdd company. See Adding a company

The same actions are in the Books menu.

Which companies are here

The Portfolio lists two kinds of company:

  • companies whose monthly books Haruno keeps;
  • companies that are not set up yet.

The company list groups them by where their books come from: QuickBooks Online, Imported monthly reports and Not set up yet. A heading shows over each group when there is more than one.

A company that has no report yet counts under awaiting a first report.

Annual reports are read in a project

A company that is read from the published statements in its annual report does not belong in the Portfolio. Drop those PDFs into a project instead. The Portfolio refuses them and says so. See Annual reports in a project.

The first time

A new Mac has no companies. The Portfolio then says Build your portfolio and offers Add company, and Import existing books… for books kept by an older version of Haruno.

What a new install shows.
The empty Portfolio with the words Build your portfolio and an Add company buttonThe empty Portfolio with the words Build your portfolio and an Add company button

Archived companies

Archive company is in a company's right-click menu. An archived company leaves the Portfolio and the month-end closes. Its books and history are kept, and its QuickBooks sync pauses.

Archived companies are listed in an Archived section at the foot of the company list, with the day each one was archived. Right-click one to Restore it or to Delete Company Data….

Delete Company Data permanently deletes that company's files, reports, settings and history on this Mac. It cannot be undone. Data in QuickBooks and on the dashboard is kept.

Where the books are kept

There is one portfolio per Mac. Haruno keeps it in its own folder, which you never need to open. You add files in the app, and reports leave through an export. To move the folder, use Settings ▸ Books. See Settings for the books.

What to tell a customer

The Portfolio is the one place to see every company. It does not need an accountant to read it. A coloured dot and a short reason tell you which company to open first.

Last updated · PR #2944 · View this version on GitHub

History (1 version)
  1. Internal knowledge base for staff: site, reader keys, assistant, 197 pages and the PR rule (#2944)
    What changed
    @@ -0,0 +1,90 @@
    +---
    +title: Portfolio and company pages
    +summary: The Portfolio is the first screen of the Mac app. It shows every company whose books Haruno keeps, with a page for each company.
    +feature: portfolio
    +covers:
    +  - apple/Sources/CFOFeature/Screens/CFOPortfolioScreen.swift
    +  - apple/Sources/CFOFeature/Panels/**
    +  - apple/Sources/CFOFeature/Shell/**
    +  - apple/Sources/CFOKit/**
    +  - apple/Sources/ShellBooks/**
    +  - apple/docs/books.md
    +---
    +
    +The Portfolio is what the Mac app opens on. It shows all your companies at once, so you can see which ones need a look. Press **⌘1** to come back to it from anywhere.
    +
    +<Shot src="/m/b96b458420bd-mac-portfolio-light.png" dark="/m/426e824f168a-mac-portfolio-dark.png" alt="The Portfolio with six tiles across the top, a bar chart of cash by company, and the company list on the left" caption="The Portfolio over the demo portfolio of ten made-up companies." />
    +
    +## What you see
    +
    +Six tiles sit at the top of the page. They add up the whole portfolio.
    +
    +| Tile | What it tells you |
    +|---|---|
    +| <Ui>Companies</Ui> | How many companies, and the month of the latest close |
    +| <Ui>Combined cash</Ui> | Cash across all companies |
    +| <Ui>Combined burn</Ui> | How much cash the companies spend each month, added together |
    +| <Ui>Under 12 mo runway</Ui> | How many companies would run out of cash within a year, and which ones. Runway is how many months the cash lasts at the recent rate of spending |
    +| <Ui>Companies with findings</Ui> | How many companies have something the checks flagged, and how many reconciliation exceptions there are |
    +| <Ui>Going-concern indicators</Ui> | Warning signs that a company may not be able to keep going |
    +
    +Under the tiles, <Ui>Cash by company</Ui> ranks the companies by cash. Below that, the companies are listed as cards or as a table.
    +
    +Each card has a coloured dot. Red means the company is in trouble: it has a stated going-concern warning, or less than six months of runway. Orange means look at it: it has a serious finding, or less than twelve months of runway. Green means nothing stands out. Under the name, the card says why, in a few words.
    +
    +A list of your companies also stays on the left. Click a name to open that company's page. You can drag the edge of the list to make it wider or narrower.
    +
    +## Cards or table
    +
    +The toolbar has a <Ui>Cards</Ui> and <Ui>Table</Ui> switch. The tiles above it do not change. The table shows more columns, and you can sort by any of them. Click a heading again to reverse the order.
    +
    +<Shot src="/m/6fd2307157f5-mac-portfolio-table-light.png" dark="/m/d6211c301117-mac-portfolio-table-dark.png" alt="The Portfolio as a table, one row per company, with columns for cash, burn, runway, findings and more" caption="The same companies as a table." />
    +
    +The sort button in the toolbar orders the cards by <Ui>Name</Ui>, <Ui>Runway</Ui> or <Ui>Findings</Ui>.
    +
    +## The toolbar
    +
    +| Control | What it does |
    +|---|---|
    +| Share button | <Ui>Export Portfolio Report…</Ui> saves one report for the whole portfolio. See [Reports and exports](/macos/books/reports-and-exports/) |
    +| <Ui>Close month…</Ui> | Closes the month for the companies that are ready. See [Closing a month](/macos/books/month-close/) |
    +| Plus button | <Ui>Add company</Ui>. See [Adding a company](/macos/books/add-company/) |
    +
    +The same actions are in the <Ui>Books</Ui> menu.
    +
    +## Which companies are here
    +
    +The Portfolio lists two kinds of company:
    +
    +- companies whose monthly books Haruno keeps;
    +- companies that are not set up yet.
    +
    +The company list groups them by where their books come from: <Ui>QuickBooks Online</Ui>, <Ui>Imported monthly reports</Ui> and <Ui>Not set up yet</Ui>. A heading shows over each group when there is more than one.
    +
    +A company that has no report yet counts under <Ui>awaiting a first report</Ui>.
    +
    +<Callout variant="warning" title="Annual reports are read in a project">
    +A company that is read from the published statements in its annual report does not belong in the Portfolio. Drop those PDFs into a project instead. The Portfolio refuses them and says so. See [Annual reports in a project](/macos/books/published-statements/).
    +</Callout>
    +
    +## The first time
    +
    +A new Mac has no companies. The Portfolio then says <Ui>Build your portfolio</Ui> and offers <Ui>Add company</Ui>, and <Ui>Import existing books…</Ui> for books kept by an older version of Haruno.
    +
    +<Shot src="/m/e606f7f902a8-mac-portfolio-first-run-light.png" dark="/m/4d3dd7fb2ac6-mac-portfolio-first-run-dark.png" alt="The empty Portfolio with the words Build your portfolio and an Add company button" caption="What a new install shows." />
    +
    +## Archived companies
    +
    +<Ui>Archive company</Ui> is in a company's right-click menu. An archived company leaves the Portfolio and the month-end closes. Its books and history are kept, and its QuickBooks sync pauses.
    +
    +Archived companies are listed in an <Ui>Archived</Ui> section at the foot of the company list, with the day each one was archived. Right-click one to <Ui>Restore</Ui> it or to <Ui>Delete Company Data…</Ui>.
    +
    +Delete Company Data permanently deletes that company's files, reports, settings and history on this Mac. It cannot be undone. Data in QuickBooks and on the dashboard is kept.
    +
    +## Where the books are kept
    +
    +There is one portfolio per Mac. Haruno keeps it in its own folder, which you never need to open. You add files in the app, and reports leave through an export. To move the folder, use <Ui>Settings ▸ Books</Ui>. See [Settings for the books](/macos/books/books-settings/).
    +
    +<Callout variant="info" title="What to tell a customer">
    +The Portfolio is the one place to see every company. It does not need an accountant to read it. A coloured dot and a short reason tell you which company to open first.
    +</Callout>