Skip to main content
This guide covers everything you need to know about using Sure, from creating your account to managing investments.
Sure is evolving quickly. If you find something inaccurate, please ask in the Discord, open an issue, or submit a PR.

Creating your account

Once Sure is installed, navigate to localhost:3000. You’ll see the login page. Click Sign Up to begin. Landing page on a fresh install Complete the setup screens to configure your login details, personal information, and preferences. When you reach the main dashboard showing “No accounts yet”, you’re ready to go. Blank home screen of Sure, with no accounts yet

Using integrations

The next sections cover how to manually add accounts and transactions. If you’d prefer to use an integration with a data provider, Sure supports: Even if you use an integration, we recommend reading this guide to understand account types and how they work in Sure.

Account types

Sure supports several account types, grouped into assets (things you own) and debts/liabilities (things you owe):
AssetsDebts/Liabilities
CashCredit Card
InvestmentLoan
CryptoOther Liability
Property
Vehicle
Other Asset

How asset accounts work

Cash, checking, and savings accounts increase when you add money and decrease when you spend money. Example:
  • Starting balance: $500
  • Add an expense of 20balanceisnow20 → balance is now 480
  • Add an income of 100balanceisnow100 → balance is now 580

How debt accounts work

Liability accounts track how much money you owe, so the math works differently than asset accounts. Key rule:
  • Positive balances = you owe money
  • Negative balances = the bank owes you (overpayment or refund)
Transaction behavior:
  • Expenses (purchases) → increase your debt (you owe more)
  • Payments or refunds → decrease your debt (you owe less)
Credit card example:
  1. Balance: $200 owed
  2. Spend 20Younowowe20 → You now owe 220 (balance goes up in red)
  3. Pay off 50Younowowe50 → You now owe 170 (balance goes down in green)
Overpayment example:
  1. Balance: -44(bankowesyou44 (bank owes you 44)
  2. Spend 1Banknowowesyou1 → Bank now owes you 43 (balance shown as -$43, moving towards zero)
This matches standard accounting and what your credit card provider shows online. Think of a liability balance as “amount owed”, not “available cash”.

Quick reference

ActionAsset Account (Checking)Liability Account (Credit Card)
Spend $20Balance ↓ $20Balance ↑ $20 (more debt)
Receive $50Balance ↑ $50Balance ↓ $50 (less debt)
Negative BalanceOverdraftBank owes you money

Adding accounts

This example shows how to add a savings account.
If you’re adding a credit card, loan, or any other debt, select a Credit Card or Liability account type instead of Cash. This ensures balances update correctly and match what your bank shows.
Most bank accounts (checking, savings, money market) are cash accounts:
  1. Click + Add AccountCashEnter Account Balance
  2. Fill in details:
    • Account name
    • Current balance
    • Account subtype (checking, savings, or other)
  3. Click Create Account
Cash Account creation menu Once created, you’ll return to the home screen. You’ll see your new account in the accounts list and an overview in the center under the net worth bar. Home screen of Sure, showing one account and no transactions

Adding transactions

To add a transaction:
  1. Go to the Transactions page (left sidebar)
  2. Click + New Transaction (top right)
  3. Choose the transaction type:
    • Expense → Spending money
    • Income → Receiving money
    • Transfer → Move money between accounts
  4. Enter the details, then click Add transaction
You’ll see the transaction in your transaction history and the net worth chart will update accordingly. Filled-out expense form

Managing investment accounts

If you’re tracking investments in Sure, there are additional features to help you manage your portfolio accurately.

Cost basis tracking

Cost basis tracking helps you understand the original purchase price of your investments, which is essential for calculating returns and tax reporting.

Cost basis sources

Sure tracks cost basis from three sources:
SourceDescription
ManualUser-entered values that you set directly
CalculatedComputed from your buy trades and transaction history
ProviderImported from your financial institution (Plaid, SimpleFin, etc.)

Priority hierarchy

When multiple sources provide cost basis data, Sure uses this priority: Manual > Calculated > Provider This means:
  • Manual values always take precedence
  • Calculated values override provider data
  • Provider data is used when no other source is available

Lock protection

When you manually set a cost basis, Sure automatically locks it to prevent automatic updates from overwriting your value. This ensures your manual entries remain intact during account syncs.

Setting cost basis manually

You can set cost basis in two ways: From the holdings list:
  1. Navigate to your investment account
  2. Find the holding in your portfolio
  3. Click the pencil icon next to the average cost
  4. Enter either:
    • Total cost basis: The total amount you paid for all shares
    • Per-share cost: The average price per share
  5. The form automatically converts between total and per-share values
  6. Click Save
The system will show a confirmation if you’re overwriting an existing cost basis. Cost basis editor From the holding drawer:
  1. Click on a holding to open its detail drawer
  2. In the overview section, click the pencil icon next to “Average Cost”
  3. Enter the cost basis (total or per-share)
  4. Click Save
After saving, you’ll see:
  • A lock icon indicating the value is protected
  • A source label showing “(manual)“

Unlocking cost basis

If you want to allow automatic updates to recalculate your cost basis:
  1. Open the holding drawer
  2. Scroll to the Settings section
  3. Find “Cost basis locked”
  4. Click Unlock
After unlocking:
  • The lock icon disappears
  • Future syncs can update the cost basis
  • Calculated values (from trades) will replace the manual value
Cost basis lock settings

Bidirectional conversion

The cost basis editor provides real-time conversion between total and per-share values:
  • Enter total cost → automatically calculates per-share cost
  • Enter per-share cost → automatically calculates total cost
This makes it easy to enter cost basis in whichever format you have available.

Investment activity labels

Activity labels help you classify and understand investment transactions. They appear as badges in your transaction list and can be used to organize and filter your investment activity.

Available activity types

Sure supports these investment activity labels:
LabelDescription
BuyPurchase of securities
SellSale of securities
ContributionMoney added to the investment account
WithdrawalMoney removed from the investment account
DividendDividend payments received
InterestInterest earned
ReinvestmentDividends or distributions reinvested
Sweep InCash swept into the account
Sweep OutCash swept out of the account
FeeAccount or transaction fees
ExchangeCurrency or security exchanges
TransferTransfers between accounts
OtherMiscellaneous transactions

Setting activity labels

You can set activity labels in two ways: Manually for individual transactions:
  1. Open a transaction from an investment or crypto account
  2. Scroll to the Settings section
  3. Find “Activity type”
  4. Select a label from the dropdown
  5. The change saves automatically
Automatically with rules: Create rules to automatically label transactions based on patterns:
  1. Go to Settings > Rules
  2. Create a new rule
  3. Set conditions (e.g., “IF transaction name contains ‘DIVIDEND’”)
  4. Add action: “Set investment activity label”
  5. Choose the label (e.g., “Dividend”)
  6. Save the rule
Investment activity rule example Example rules:
  • IF name contains “DIVIDEND” THEN set label to “Dividend”
  • IF name contains “INTEREST” THEN set label to “Interest”
  • IF name contains “FEE” THEN set label to “Fee”
Rules apply automatically to new transactions and can be run on existing transactions.

Viewing activity labels

Activity labels appear as badges in:
  • Transaction lists
  • Transaction detail drawers
  • Account activity views
They help you quickly identify the nature of each investment transaction without reading the full transaction name.

Next steps

Now that you have your account set up:
  • Explore other account types that Sure offers
  • Categorize and tag transactions for better searching and reporting
  • Experiment with budgets to track your spending habits
  • Use bulk import to load historical transactions