Help · App reference

The Rebalance Planner

From RangefinderInvest's built-in help · applies to version 0.59.3

The Rebalance Planner turns the gap between your target model and your actual holdings into a concrete, illustrative trade list. One engine, three modes:

  • Rebalance: drift → suggested trades per account, slice and ticker. Add / Reduce / Close / Deploy lead while Hold rows stay behind Show N holds. The summary gives order count, dollars, closures, cash deployment and a known or explicitly unknown tax estimate.
  • Withdraw and Contribute open with the Amount empty: no plan and no shortfall line appear until you type a figure, so nothing is sized against a number you never chose. The Amount is a dollar field: type 10000 or $10,000. With no accounts at all, every mode says to add one first, which is a different state from having every account left out of rebalancing.
  • Withdraw: choose how cash is funded, see the tax-aware order with tax/harvest flags, then rebalance now or defer.
  • Contribute: buy-only rebalancing. Nothing is sold, so no gains are realized. The plan places the contribution plus any cash already above the model's cash target, spread over every under-target slice in proportion to how far each is below target, and never more than that gap. The totals line says how much is placed of how much is available. Money the slices cannot take is shown as unallocated, part by part, with its cause named. Cash already in an account above its cash target can only fund that account's own slices, so if none of them reads below target it stays unallocated there, even while another account is still short. Contribution is unallocated only once no slice reads below target in any account the money was split over (an empty account left out is not one of them). Either happens only with a model whose slices total less than 100%, or a fund used in more than one slice (each such slice counts the whole holding, so it reads fuller than it is). A slice's share under one cent is not an order; it is added to that account's largest order instead. Cents left over only because every remaining slice is under a cent short are shown as too small to place. A cash slice below its target keeps its share as cash. The drift threshold and minimum trade size do not apply here, so Contribute does not show them; Frequency is a Withdraw control (it feeds the reserve runway) and is not shown either. ETF and stock orders round down to whole shares, so the share estimate never spends more than the Buy amount.
  • Contribute across several accounts splits the money in proportion to what each account holds now. Whatever one account's slices cannot take goes on to the accounts still below target. Cash already in an account stays in that account. An account that holds nothing yet therefore receives none of it, and the page names it. To fund a new account, choose it alone under Contribute to: it then receives the whole amount.

Before interpreting an empty result, the page checks every account in the selected scope. If at least one account has complete setup and valued inputs, its orders and totals remain visible. An account excluded notice names each account omitted from the result and links to its recovery step. The page uses a full recovery state only when no account in scope can produce a trustworthy result:

  • If no account is eligible for the current mode, go to Accounts and turn on the needed planning flags. Withdraw requires both Rebalance and Withdrawals; the other two modes require Rebalance.
  • If an eligible account has no assigned model, or its assignment no longer points to a model, that account is excluded until you choose one on Accounts.
  • If the current model version has no executable allocation, go to Target Models. Every ordinary positive-weight slice needs a positive-weight fund, and every fund line that carries a share of a slice needs a ticker: a line added with Add fund and never named is money no order can place, so the model is incomplete until you name it or remove it (a 0% blank line is just a placeholder). Ladder and self-directed slices may intentionally be fundless.
  • Rebalance and Withdraw need a holding or cash balance. If the selected accounts have none, go to Holdings and import or enter them. Contribute remains usable with a valid empty model because the contribution itself can establish the allocation, when the empty account is the one selected or every selected account is empty.
  • Every holding needs a price, in all three modes. A fund with no price would count as $0 held, so the page would size the account too small and order more of a fund the account already owns. One unpriced holding is therefore enough to exclude its account, even beside priced holdings or cash, and the notice names the tickers that have no price (the first four by name, then how many more). Go to Settings → Price data and repair the price source or stored prices.

These checks prevent one account's missing prerequisite from hiding another account's real orders, and prevent an all-blocked scope from looking like an empty table, an amount error or a portfolio that is already on target.

Drift threshold makes small gaps Hold; minimum trade size floors out noise-sized orders. These are the same settings the Overview summary uses. They govern Rebalance and Withdraw; a contribution places every dollar, so Contribute uses neither.

Account pins left and Action / order pins right, and the order tables are sized to fit the window's 1180-pixel minimum without a column sliding under the pinned edge; if a narrow window still leaves a column beyond it, a soft shadow on that edge says the table scrolls. The Rebalance table keeps the percentages and the signed Drift $, with the security type under the ticker; the dollar target and current values, and why the row exists, are in the real Review button's panel. Contribute keeps its Buy $ column: for a whole-share fund the order beside it states the floored share cost ("Add 4 shares SPY, approx. $2,400" for a $2,907 buy), and the totals line sums the planned amount. The fit assumes the default sidebar width; at its widest setting the table scrolls and the shadow shows it. The trade, withdrawal and contribution tables are named keyboard regions: Tab to the table boundary, then use Left/Right to scroll to clipped columns. Action chips combine freely. Until you change a chip or filter control, the action-first selection follows live rows whenever the threshold, minimum trade, models, holdings, account selection or database changes. Your first filter action makes it a custom selection, which is then preserved for the rest of the session, including across a database switch. Show all is also a custom filter action. Export CSV · visible rows exports only trustworthy rows that those filters show, with raw numbers, then names every account excluded from the result and why. Withdraw's funding-orders export carries the same exclusion block, so a saved plan never silently omits an account that could not be evaluated.

Nothing to trade means every usable row is genuinely within the drift threshold. A plan whose only potential orders are below the minimum trade is identified that way; it is not called on target. Nor is a cash slice that sits below its target while every position is inside the drift threshold: nothing is far enough over target to sell for it, and the page says exactly that rather than blaming the minimum trade.

Uninvested settlement cash is a separate actionable state. When the page shows Deploy $N, the summary and cash row carry that next step even if every security order is below the minimum trade size. The page does not show a simultaneous No order clears warning for the same result.

Full closures, missing cost basis and possible wash sales remain in expandable Trade checks below the orders; the summary keeps the consequence visible. Close looks different from a routine reduction because it exits the position.

Withdraw mode reads equity drift, drawdown and reserve months to suggest a strategy. The account selector narrows funding orders, while reserve runway remains a household-wide fact; an account with incomplete setup or unusable balances is excluded from that advice. An account excluded only because a holding has no price still counts its priced cash and maturing fixed income toward the runway. If an unpriced holding is one the runway would count (a money market or cash holding, or a bill, note, CD or bond maturing within 12 months, that is on or before the same date next year), the advice names it as not counted. It describes your portfolio; it never predicts markets. You choose. A one-time withdrawal has no months of runway: the advice compares your reserves with that one amount instead, and a bill that has matured, or whose maturity the app cannot read, is not counted as a reserve.

Everything on this page is illustrative, not advice. Confirm prices, lots, wash-sale exposure and suitability with your broker or advisor before placing real orders.