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.
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.
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):
| Assets | Debts/Liabilities |
|---|
| Cash | Credit Card |
| Investment | Loan |
| Crypto | Other 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 20→balanceisnow480
- Add an income of 100→balanceisnow580
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:
- Balance: $200 owed
- Spend 20→Younowowe220 (balance goes up in red)
- Pay off 50→Younowowe170 (balance goes down in green)
Overpayment example:
- Balance: -44(bankowesyou44)
- Spend 1→Banknowowesyou43 (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
| Action | Asset Account (Checking) | Liability Account (Credit Card) |
|---|
| Spend $20 | Balance ↓ $20 | Balance ↑ $20 (more debt) |
| Receive $50 | Balance ↑ $50 | Balance ↓ $50 (less debt) |
| Negative Balance | Overdraft | Bank 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:
- Click + Add Account → Cash → Enter Account Balance
- Fill in details:
- Account name
- Current balance
- Account subtype (checking, savings, or other)
- Click Create Account
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.
Adding transactions
To add a transaction:
- Go to the Transactions page (left sidebar)
- Click + New Transaction (top right)
- Choose the transaction type:
- Expense → Spending money
- Income → Receiving money
- Transfer → Move money between accounts
- Enter the details, then click Add transaction
You’ll see the transaction in your transaction history and the net worth chart will update accordingly.
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:
| Source | Description |
|---|
| Manual | User-entered values that you set directly |
| Calculated | Computed from your buy trades and transaction history |
| Provider | Imported 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:
- Navigate to your investment account
- Find the holding in your portfolio
- Click the pencil icon next to the average cost
- Enter either:
- Total cost basis: The total amount you paid for all shares
- Per-share cost: The average price per share
- The form automatically converts between total and per-share values
- Click Save
The system will show a confirmation if you’re overwriting an existing cost basis.
From the holding drawer:
- Click on a holding to open its detail drawer
- In the overview section, click the pencil icon next to “Average Cost”
- Enter the cost basis (total or per-share)
- 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:
- Open the holding drawer
- Scroll to the Settings section
- Find “Cost basis locked”
- Click Unlock
After unlocking:
- The lock icon disappears
- Future syncs can update the cost basis
- Calculated values (from trades) will replace the manual value
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:
| Label | Description |
|---|
| Buy | Purchase of securities |
| Sell | Sale of securities |
| Contribution | Money added to the investment account |
| Withdrawal | Money removed from the investment account |
| Dividend | Dividend payments received |
| Interest | Interest earned |
| Reinvestment | Dividends or distributions reinvested |
| Sweep In | Cash swept into the account |
| Sweep Out | Cash swept out of the account |
| Fee | Account or transaction fees |
| Exchange | Currency or security exchanges |
| Transfer | Transfers between accounts |
| Other | Miscellaneous transactions |
Setting activity labels
You can set activity labels in two ways:
Manually for individual transactions:
- Open a transaction from an investment or crypto account
- Scroll to the Settings section
- Find “Activity type”
- Select a label from the dropdown
- The change saves automatically
Automatically with rules:
Create rules to automatically label transactions based on patterns:
- Go to Settings > Rules
- Create a new rule
- Set conditions (e.g., “IF transaction name contains ‘DIVIDEND’”)
- Add action: “Set investment activity label”
- Choose the label (e.g., “Dividend”)
- Save the rule
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