rocket_launch

Getting Started

Sign in and set up your first portfolio in under a minute.

1
Open the app

Navigate to the application URL in your browser. You'll land on the login page.

2
Sign in with Google

Click Continue with Google and complete the OAuth flow. Your account is created automatically on first sign-in.

3
Create your first portfolio

You land on the Portfolios tab. Click next to "Individual Portfolios" and give it a name.

4
Deposit initial cash (recommended)

Click 💷 Deposit/Withdraw and deposit your starting capital in GBP so the Insights charts reflect your full history.

5
Add your first security

Click inside the portfolio card, enter the ticker (e.g. AAPL:NSQ), quantity, and purchase price.

info All data is stored per-user based on your Google account. No one else can see your portfolios.
dashboard

App Layout

Everything lives in a single-page app with a persistent top bar.

The top bar looks like this:

rocket_launch AlphaGenio
Portfolios Insights Research Agents
sync Refresh help person
tab Tab bar

Switches between the four main pages.

sync ↻ Refresh Prices

Scrapes FT Markets for the latest prices across all your securities.

help Help icon

Opens this guide.

account_circle Profile avatar

Click to see your name, email, and a Logout link.

lightbulb On mobile, swipe down anywhere on the page to trigger a pull-to-refresh price update.
account_balance_wallet

Portfolios Tab

Your main workspace — Groups at the top, individual portfolios below.

create_new_folder Creating & Managing Portfolios

Action How
Create Click next to "Individual Portfolios" → name it → Create
Rename Click the edit pencil icon on the portfolio card header
Delete Click the delete trash icon → confirm
Reorder Drag the portfolio card header to a new position

add_circle Adding Securities

1
Click + inside a portfolio card

Opens the Add Security form.

2
Fill in the form

Enter the symbol (e.g. AAPL:NSQ or BRBY:LSE), quantity, purchase price in GBP, and purchase date.

3
Optional: Deduct cost from Cash

When checked (default), quantity × price is automatically subtracted from the portfolio's cash balance.

4
Click Add Security

The holding appears in the portfolio. Hit Refresh Prices to fetch its current market value.

warning The symbol must match the exact TICKER:EXCHANGE format used by FT Markets. If a price can't be fetched, the row shows "N/A" until a successful refresh.

sell Selling a Security

Click the sell icon on a security row. Both partial and full sales are supported.

info Partial sales reduce the original holding and create a separate "Sold" record — preserving historical cost basis and realised P&L.

currency_pound Cash Management

Every portfolio has a special CASH pseudo-security (always priced at £1.00).

Via dedicated button

Click 💷 Deposit/Withdraw → choose type → enter Amount (GBP) & Date → Process Cash.

Automatically via Buy/Sell

Cash is adjusted when adding a security with "Deduct cost" checked, or selling with "Credit proceeds" checked.

lightbulb Always deposit your initial capital into CASH first. This ensures Insights charts correctly reflect your total invested capital from day one.

folder_shared Groups

Groups aggregate multiple portfolios for combined performance analysis in the Insights tab.

Action How
Create Click next to "Groups" → name it → check portfolios → Create Group
Edit Click the pencil icon on the group card
Delete Click the trash icon → confirm

history Price History

Click the history history icon on any security row to view a line chart and scrollable table of historical close prices and daily % changes.

insights

Insights Tab

Performance analytics over any chosen date range.

tune Controls

folder_shared Group selector

Choose All Portfolios, a specific Group, or an individual Portfolio.

date_range Date pickers

Filter the From / To date range for the chart and table.

show_chart Performance Trend Chart

Dataset Description
Total Value (GBP) Absolute portfolio value over time — indigo filled line on the left axis
Cumulative Change (£) Running P&L in pounds — emerald line on the right axis
Change % Period-over-period % change — green/red bars
Cumulative % Running % return — amber dashed line

Hover any data point to see a combined tooltip. Click the chart card to toggle the Performance Table.

info Historical data must exist for the chart to populate. Enable the Historical Data agent on the Agents tab to backfill missing records automatically.
edit_note

Research Tab

Compare securities and keep personal investment notes.

search Security Performance Lookup

1
Search for a security

Type a name or ISIN (e.g. "Apple" or "US0378331005") into the search box.

2
Select from the dropdown

Click a suggestion. The security appears as a coloured tag below the search box.

3
Adjust dates & add more securities

Repeat the search to compare multiple securities. Each gets its own colour on the chart.

4
Read the chart

All securities are normalised to a £1,000 hypothetical investment for fair relative comparison.

info Click on a tag to remove a security. Click ↺ Reset to clear everything and start over.

note_stack Research Notes

A personal scratchpad for investment ideas, stored per-user.

Action How
Create note Click + New Note
Expand / Collapse Click the note card header
Edit content Click into the note body and type freely
Delete note Click the trash icon on the note card

Notes are auto-saved when you navigate away from the Research tab.

smart_toy

Agents Tab

Background workers that keep your data fresh automatically.

toggle_on Available Agents

history
Historical Data

Scans all securities from purchase date to today and backfills missing daily price data from FT Markets.

photo_library
Historical Snapshots

Calculates and stores daily portfolio value snapshots — the data that powers your Insights charts.

update
Price Updates

Automatically refreshes live prices for all securities every 15 minutes.

table_chart Status Tables

history Historical Coverage

Shows per-security data completeness: Complete / Partial / Missing and number of missing days.

photo_library Snapshot Status

Shows per-portfolio snapshot completeness: Synced / Partial / Missing.

receipt_long Price Update Logs

Live log of automatic price refresh runs — security, time, price, status.

lightbulb The Agents page auto-polls every 5 seconds — all status tables refresh live without a manual page reload.
currency_exchange

FX Conversion

All values are tracked in GBP. Foreign prices are converted automatically.

USD

US Dollarprice × USDGBP rate

EUR

Europrice × EURGBP rate

GBX

Pence sterlingprice × 0.01

GBP

British PoundNo conversion needed

warning Purchase prices are always entered and stored in GBP. FX conversion is applied only to the current market price when calculating current value and P&L. The FX rates (USDGBP, EURGBP) are refreshed whenever you trigger a price refresh.
tips_and_updates

Tips & Gotchas

Common pitfalls and power-user tricks.

label
Symbol format

Always use TICKER:EXCHANGE (e.g. VUSA:LSE, AAPL:NSQ). ISINs work in Research lookup but the canonical trade record needs the exchange suffix.

currency_pound
CASH symbol

Use the dedicated Deposit/Withdraw button rather than manually adding a CASH security, to avoid duplicate records.

call_split
Partial sales preserve history

Selling fewer units than you hold creates two records — the reduced original and a new sold record. This is intentional for accurate cost-basis tracking.

data_alert
Historical gaps

If the Insights chart is empty, enable the Historical Data agent and wait for it to backfill missing data. This can take a few minutes on first run.

schedule
Price delays

FT Markets prices are end-of-day / delayed. Real-time intraday prices are not available.

drag_pan
Drag to reorder

Both portfolio cards and individual security rows within a portfolio can be dragged to reorder them.

show_chart
Research chart normalisation

The lookup chart assumes a fictional £1,000 starting investment for all securities — it's a relative comparison tool, not an absolute value tracker.

date_range
Insights default date range

The default view shows data from 2 January 2026 to today. Use the date pickers to zoom in or out.