Documentation

Quick Start

Fortunest turns the CSV exports your brokers and exchanges already give you into one live dashboard. Here is the shortest path from nothing to seeing your whole portfolio — and the handful of things worth knowing on day one.

Find a page or section: use the documentation search bar above, or press ⌘/Ctrl K. Search a keyword or put an exact phrase in quotes. Results link directly to matching sections; arrow keys navigate them and Escape closes search.

Three steps to a live dashboard

  1. Open the app Go to app.fortunest.ai. There is nothing to sign up for — you start as a guest and everything works. Your browser gets its own private session; an optional account comes later if you want your data to follow you across devices (see Privacy & your data).
  2. Drop in your broker exports Export your transaction history as CSV from your broker or exchange — Degiro, Revolut, Interactive Brokers, Kraken, Binance and Trezor Suite are supported, and Getting your data in shows exactly where each export hides. A new account starts with one step, Bring your portfolio: its first button, Drop a screenshot or PDF from your broker, has the AI read a screenshot of your positions or a PDF statement, and you check every row before anything is added. Later puts it away. An empty portfolio opens on two doors: Add my portfolio (a screenshot or PDF from your broker, read with AI, comes first there too) opens a drop area right there — drag the files onto it, or click to browse — plus buttons for a broker connection, an exchange API key and assets added by hand; you can also open ⚙ Settings → Data and drop them there. The format is detected automatically; you can drop a whole folder and every supported CSV inside is imported. No exports at hand? The other door, Explore the demo, loads a realistic sample portfolio (synthetic transactions, live prices) — four accounts spanning stocks, ETFs and crypto, so you can see what a loaded dashboard looks like before you export anything. It arrives already calculated: the server prepares the demo in advance, so there is no import or recalculation progress — the portfolio simply appears. A slim Demo portfolio bar above it keeps Add my portfolio one click away; once a file of your own is in, it asks whether to Remove the demo (or Keep both). You can also remove it any time in ⚙ Settings → Data.
  3. Read your portfolio The engine values every position with live market data, split-correct, converted at each day's real exchange rate. Within a minute you're looking at your total value and today's change, a value chart against real benchmarks, and a sortable table of everything you hold.
The Portfolio tab: the value tile with its account donut and day change, the cash, total P/L and portfolio-fundamentals card beside it, the portfolio value chart against two benchmarks, and the assistant docked on the right
The Portfolio tab right after loading four broker exports — value and day change, stats and the value chart, with the assistant docked on the right (shown here before a model is connected, which is how it opens).

Take the tour

Once there is a portfolio on screen — the demo or your own — a one-line Get started sits above it, naming its next step (Get started · 1 of 4 done · Keep your portfolio ›); click the line to open the card, and its title to fold it back. Its four steps tick themselves off as you do them. Only the current step shows its buttons; the later ones sit folded to their titles and open in turn — a step ahead of the current one cannot be opened early. A finished step's title stays clickable: it reopens the step so you can change your answer (more of your own data, an account after all, a different strategy), and a second click folds it back. ① Your portfolio is in (or Demo portfolio loaded) is already ticked; reopened, its Add your own data opens a drop area for your broker exports plus Connect an account or add assets →, which opens ⚙ Settings → Data at Connect an account. You can also add holdings later just by telling the assistant in the chat what you own. Its How your data is handled → link lists, on hover, where your portfolio is kept and who can see it, and opens Privacy & your data on a click; on a phone the first tap shows the list and a second tap opens the chapter. ② asks about an account: on your own data it is Keep your portfolio — a guest session expires after 12 hours of inactivity, a free account keeps it on every device — and on the demo alone it is Create a free account. Continue as a guest answers it just as well (the simpler answer on the left); signed in, it is ticked already. The app has no Get started on an empty portfolio: the two doors are its first screen. In the desktop app, which keeps your data on your own disk, there is no account step. The Set your strategy step holds the same Risk, Horizon and thesis fields as ⚙ Settings → Strategy, with the defaults filled in, in the order you fill them: pick a Risk preset, edit the thesis it writes or replace it with your own words, then set the Horizon. An untouched preset reads grey with a note under it saying it is the preset text; your own words turn it back to normal ink, and a Risk change never replaces them. Confirm and continue saves the three and moves on to the last step; the ⚙ Settings → Strategy link in the step's text opens that tab. While the card is showing, the assistant waits minimized to its AI button in the corner, so the first screen is just your portfolio and the Get started line — click the button any time to open it yourself. The card's last step, Meet the assistant (Ask the assistant anything — how the dashboard works, what a number means — or talk through your strategy. Or take one of its interactive tutorials.), has one button: Open the AI assistant chat opens the assistant — docked beside the dashboard, or the bottom sheet on a phone — with the caret already in the ask box, ready to type, and ticks the step. Once you have met the assistant — sent it a question, started a walkthrough or pressed that button — or the card is finished or closed, it opens docked on every new visit, as it always did. When every step is ticked the card says All set — you can close this card with ✕ now. The card is for new users only: once you have finished it or closed it, it stays gone for your account, so signing in on another phone or computer does not bring it back.

The tutorials are in the chat's Learn card, and the empty Portfolio value tile's 🎓 Take the tour starts the tour straight away. The walkthrough is the same one the Learn card in the chat starts — and asking for it works too ("start the tutorial"). Each step scrolls to the card it is about and rings it, drops a short plain-language explanation into the conversation, then waits: you can ask anything in between without losing your place. The Learn card sits under the assistant's report cards and starts folded into its title line — Learn with two chips, Dashboard tour and Investing Foundations; click a chip to open its tile, click it again to fold it. Opened, it offers both walkthrough kinds as two equal tiles, in the learner's order: the 🌱 Investing Foundations Course first, the 🎓 Dashboard tour second (New here? A guided lap — each step scrolls to the card it explains; ask anything in between.). The tour has three levels, picked on a sliding Beginner / Intermediate / Advanced control with the Take the tour button at the end of the same row (it wraps under the control, right-aligned, when the chat is narrow) — the pick is remembered, and only the button starts anything; a level you have begun shows n of N done beside the control and the button reads Continue tour, picking up at the furthest step you reached; the ⓘ beside the tile's title says what each level covers: Beginner (the Portfolio tab’s numbers card by card — the pie, the heatmap and Time travel included — plus every way to add data, the AI assistant, the keyboard shortcuts and the smart AI search, the asset search, your watchlists and sharing with friends), Intermediate (the rest of the Portfolio tab, your portfolio’s fundamentals among it, how to zoom, move and measure on a chart and that Esc closes drawers, popups and dialogs, then the Trades tab) and Advanced (what-if trades, the simulator, your tax position and the professional extras). A level you have finished shows a ✓ on its pill and the tile reads Done ✓ Advanced · Retake — unlike the course, a finished tour level keeps its offer, because replaying one lap of the app is a normal thing to want; with nothing picked the control defaults to your first unfinished level. Playback is local, so the tour runs even with no model connected — only the questions in between need one — and started with nothing loaded it seeds the demo portfolio first, so every step has real numbers to point at.

Never invested at all? The Learn card's first tile is for you: 🌱 Investing Foundations Course — New to investing? 25 short steps: stocks, index funds, risk, fees, strategies, … ~30 min. It teaches investing itself rather than the app — what an investment actually is, what decides your outcome, how to write your own plan — and it runs on a completely empty portfolio: nothing is loaded for you. Its button follows where you are: Start course, then Continue course with n of 25 done (it picks up at the furthest step you reached, not step 1) — and once you have finished it, its chip on the Learn card's title line reads Investing Foundations ✓ with a green tick. The chip stays clickable — one click brings the whole tile back with a quiet Restart course, another folds it away — and the course is one sentence away besides: type "restart the investing course" (or "I want to do the Foundations course again") into the chat and it starts from step 1, exactly as on a fresh account. The dashboard tour's chip gets its tick once every level is done (Dashboard tour ✓, clickable open to a Retake). At most one button on the card is lime — among the open tiles, the course's until the course is finished, then the tour's for a level you have not taken; the chips never are, and a finished walkthrough's tile is a retake and never takes it. The Get started card points at it through its last step: Open the AI assistant chat opens the chat with the Learn card in it.

Your portfolio at a glance

Five things on the Portfolio tab answer most day-to-day questions:

The top bar packs itself down as the window narrows, and the assistant panel counts: docking it to the side takes width from the page without taking any from your screen, which is why the header changes shape when you open it on a window that was comfortable a moment before. In order: the tab strip shrinks and scrolls in place behind the buttons; then it takes a row of its own, lined up with the Fortunest wordmark and clear of the logo, while the Feedback, ⚙, bell and account buttons stay exactly where they were on the first row with the search pill; and below the width where even that fits, the assistant panel folds back into its button rather than squeezing the header any further. It gives way gradually before that — the panel narrows toward its own minimum first, so the page keeps the room the header needs — and re-opening it at that width is respected, not undone. Narrower still and you are on the phone layout, where the controls move to a panel at the bottom of the screen and the strip of page beside a card halves, so the cards take almost the whole width and there is more room for what is in them; the bottom panel and the assistant’s key line up with the same edge. The Fortunest name stays on the bar the whole way down. It used to stand down a little before it had to — the name vanished while a visible gap was still sitting where it had been — so the four header buttons now close up slightly at the tightest widths instead, which buys the name more room than the header can ever run out of. If some future arrangement did run out, the name is still what gives way first (a row of buttons wrapped on top of the logo is worse), and the tab row underneath keeps its place either way.

The compact phone header stays fixed while the page scrolls beneath it. Its veil fades smoothly from fully transparent and unblurred at the lower edge into strong blur and the opaque page colour above. Desktop keeps its existing translucent glass. When a table’s labels are pinned below the header, the space above them stays solid so earlier rows cannot show through. On a narrow phone (360 pixels wide, common on Android) the header’s buttons sit a little closer together so the whole row fits the screen — every button keeps its size, and the page is never zoomed out to make room. On the narrowest phones (under 360 pixels, such as 320) the Feedback button shows just its speech-bubble icon, without the word; tapping it opens the same feedback dialog.

The Fortunest logo at the left of the top bar — the nest with a coin turning inside it — holds still if your system asks for reduced motion (Reduce motion on a Mac, iPhone or iPad; animation effects switched off on Windows; Remove animations on Android): the coin rests face on, showing its dollar side. Change the setting while the page is open and the logo follows straight away, stopping or turning again. The Fortunest name beside it honours the same setting: its letters rise into place once when the app opens, and with reduced motion they are simply there from the start.

Things move instead of jumping. The headline figures on the Portfolio tab — Portfolio value and its day change, Cash, Total P/L and the returns — roll their digits to the new value after a refresh, a currency switch or a Time-travel day. Choosing a tab from the tab strip switches it at once and slides the new page in from the side you are heading to — the page itself, so everything on it can be clicked while it settles, and table headings pinned under the top bar travel with their tables. Sorting the Holdings, Explore and trade-candidate tables glides the rows to their new places, and filtering Holdings shrinks leaving rows away and pops new ones in; sort again or flip the filter back while rows are still moving and each one carries on from exactly where and how big it is, never flashing to full size, and rows on their way out stay with the table if you scroll. Click or tap while something is still moving and the click goes to what you see under your pointer: inside a page that is still sliding in, the page stops where it is while you hold the button down — so what you pressed stays under your pointer — then settles as the click lands on it; another tab carries the page on from wherever it is; a menu or a field takes the click as usual; and a row that was still gliding ignores it rather than opening a different one. The asset details panel, the sheets, the investing notes, the assistant’s memories and every maximized chart arrive with a gentle spring, expandable sections visibly open and close, their content fading in under the heading, the top bar gains a subtle shadow as you scroll, and Social feed posts rise into place as they come into view. The Value per asset pie unfolds when it appears — on the Portfolio tab once you have scrolled to it, and in a friend’s shared portfolio on the Social tab, where their category pie unfolds the same way for each friend you open — its category ring grows outward, then each holding’s wedge opens clockwise like a petal, overshooting a touch before it settles, labels fading in as they land — all within 0.7 seconds; opening a category or sector unfolds its own pie the same way. The pie unfolds without shadows; they are drawn once it has landed, every slice’s at the same moment, which keeps the unfold smooth on a large portfolio. The Risk card’s volatility, the Simulator’s goal and the Portfolio value card’s account ring sweep to their value when they come into view, progress bars shimmer while work is under way, and the Pro badge has a slowly turning border. Pick a different period or view on a chart and each line draws itself in like a pen stroke, a small glowing dot in the line’s colour riding its tip and every line at its own slightly different speed, while the shaded area fades up behind the portfolio’s line and trade markers appear as the pen passes them; turn on a benchmark or another line and only that line draws. Open a chart full screen with ⤢ and its lines draw in the same way as the larger frame rises into place; closing it again does not replay it, and neither do opening the tab, zooming or hovering. With reduced motion on, none of it moves — values simply change — and a browser without support for an effect shows the change instantly.

The tabs across the top — Portfolio, Explore, Trades, Simulation, Taxes, Social — switch the whole view, and the tab you are on is written into the address bar (#explore, #trades, …): reloading keeps your place, your browser’s Back and Forward buttons walk the tabs you visited, and a tab can be bookmarked or its link shared. Portfolio is the plain address with no # at all — the URL you already know keeps opening the dashboard exactly as before. Back closes an open panel first: with an asset’s details, a report, ⚙ Settings or Manage account open, the first Back closes that panel (the most recent one when two are stacked) and only the next moves through the tabs; a panel closed with its ✕ leaves no extra step behind. On a phone you can also swipe the page sideways to move through them: left for the next tab, right for the previous one — and a run of swipes counts as one step in your history, so a single Back returns to the tab you started swiping from (tapping a tab adds a step of its own, as does a link inside the app; the assistant’s own tab hops coalesce like swipes). The page follows your finger the whole way — right off the side of the screen if you swipe that far — and fades toward the tab it is about to hand over to, so you can see the switch coming and let go early to call it off; the header and the bar at the bottom stay exactly where they are, and at the far end of the row — past Social — the page barely moves, which is how it tells you there is nothing further that way. The other end does have something further: swipe right on Portfolio, one step past the first tab, and the ⚙ Settings dialog opens — the page nudges and dims as you drag, exactly the dimming that means “letting go will commit”, and past the same distance that would switch tabs, releasing opens Settings just as tapping the gear would; let go early and nothing happens. While you drag, the empty space the page reveals names what letting go will bring — “Explore”, “Taxes”, “Settings” — written vertically along the edge, so you never have to guess where a swipe leads; a dead end shows no name at all. The Settings edge keeps going: swipe the same way again inside the Settings dialog and Manage account opens; swipe the opposite way to walk back — Manage account to Settings, Settings to the page you were on — with each sheet following your finger and the revealed space naming the destination. Swipes that already mean something else — panning a wide table, dragging a zoom on a chart, anything inside the assistant or an open dialog — are left alone.

On a phone, a gesture only ever goes one way. Whichever direction you set off in during the first few millimetres is the direction that touch keeps until you lift your finger: pan a wide table sideways and the page behind it stays put, start scrolling the page and the table cannot slide out from under you, however much your thumb wanders. Nothing ever drifts diagonally, and a scroll that curls sideways at the end can no longer flip you into the next tab by accident. Scrolling up and down is your phone’s own, everywhere — the tables included — with its full native glide and momentum; only the sideways pan on a wide table is drawn by the app, and it is drawn only when the vertical scroll was genuinely not started, which is what makes the lock hold every time rather than most times. The whole thing is touch-only — a mouse or a trackpad behaves exactly as before. And since 1 September 2026 a pinch never zooms the page: two fingers on a chart zoom that chart’s own time window (see the value chart), and anywhere else the pinch simply does nothing, so the layout can never end up half-zoomed under a stray gesture. A tap or a sideways drag on a chart reads the chart — the tooltip follows your finger with the date and values — while a sideways drag anywhere off a chart is still the tab swipe above. The two never talk over each other: while two fingers are pinching, the tooltip stays hidden for the whole gesture and comes back on your next one-finger touch. And since 4 September 2026 every hover tip opens on a tap: the ⓘ glyphs, the price-trend sparklines, 52-week ranges and weight bars in the Explore tables, the lot timeline on the Trades tab and the Maturing-lots bars on the Taxes tab all carried their detail in a tip a finger could not reach. Tap one to read it; tap it again, tap anywhere else, or scroll on, and it goes away. A tap that opens something — a heatmap cell, a Holdings or Explore row opening that asset’s details — shows just what it opened: no tip is left standing over the panel (since 6 October 2026).

Add it to your Home Screen and it opens like an app. There is no app store and nothing to install — on an iPhone, open app.fortunest.ai in Safari and tap Share › Add to Home Screen; on Android, the browser menu’s Add to Home screen. It gets its own icon on the Home Screen, and tapping it opens the dashboard full screen — no address bar and no tab strip, straight into your portfolio. It is the same app and the same data as on your desktop, signed in the same way; nothing is downloaded to the phone and nothing works offline there (the desktop app is what runs without a connection). If you would rather not, the ordinary browser tab keeps working exactly as it always did.

On a phone you can also pull down from the very top of the page to refresh your prices. A gap opens above the content as you drag, and the text in it tells you where you are: Pull down to refresh prices, then Release to refresh prices once you have pulled far enough — let go earlier and it simply springs shut without fetching anything. When you do let go, the same gap reports each step as it happens: fetching live prices & FX from the market feed, then recalculating your summary, reloading the charts and refreshing the cards, with a tick beside each one as it lands. Only the market data is re-fetched — the app itself is not reloaded. Your tab, your place on the page and anything you had open all stay exactly as they were, which is the one thing your browser’s own pull-to-refresh could not promise: it reloads the whole app to show you the same numbers. If the market feed cannot be reached, it says so rather than claiming success — Couldn’t reach the price sources — showing the last known prices, with a red ✗ against the step that failed, so you always know whether the numbers in front of you are the ones you just asked for. The gesture only starts at the top of the page and only on a downward pull, so it never interrupts a scroll, and it leaves the assistant, dialogs, charts and sideways-scrolling tables to themselves. While you pull, the app takes the whole gesture, so the browser’s own pull-down (the rubber band, or Chrome’s reload actions) does not run underneath it; and once the gap has closed the page settles back to the very top, so the first card is not left tucked under the header — unless you scrolled a screen or more away while the prices came in, in which case you are left where you were (since 18 September 2026). On the Social tab the same pull refreshes only the social side (since 21 August 2026) — the feed, the unread badge and your friend requests, with the gap reading Release to refresh your feed and closing on Feed up to date — and touches no price at all, which is why it finishes almost at once; on every other tab the price refresh runs as described, with the social badge check fired first, since it is the quick half.

Optional: connect the assistant

The chat pane on the right becomes an analyst once you connect a language model — it sees your holdings, your screen and your last actions, writes one-click reports, adds the ✨-marked AI features everywhere, and can even drive the dashboard for you: type "Go to allocation" or "What if I sell half of my Tesla?" and it performs the action, then comments on the result. Nothing calls an LLM (and no tokens are spent) until you press Connect.

Open ⚙ Settings → Assistant and pick a provider:

The full setup — including the two model slots and what each one powers — is in The Assistant.

Where to go next