Nested Flow
A personal operating system for tasks, habits, goals, finances and trading —
connected, not merely co-located.
⚠️ "Nested Flow" is a working name with a known conflict. A preliminary search
found an active Kylix Finance in the same sector and a registered Borland
mark. See docs/NAME-RESEARCH.md. No trademark
clearance or domain availability has been established, and the recommendation
is to rename before any public use.
Status
All nine core modules are built, tested and verified: auth and account
settings, dashboard, tasks and projects, goals and habits, finance, trading
journal, notifications, query/export primitives, and privacy controls. A
user-editable rules engine and a focus-timer UI are not started.
| Gate | Result |
|---|
| Lint / format / typecheck | clean |
| Dependency audit | no known vulnerabilities |
| Unit + integration tests | 217 passing against real PostgreSQL |
| End-to-end tests | 23 passing in Chromium, production build |
| Build | 20 routes |
Full evidence in docs/STATUS.md.
What it does
- Dashboard — every widget reads real records. Nothing is seeded or
simulated; a widget with no data says so and links to the action that would
fill it. The attention panel surfaces overdue work, streaks about to break,
goals behind pace, budgets exceeded, and runs of losing trades.
- Tasks — projects, priorities, scheduled days, hard deadlines, search,
filtering, sorting, pagination, and RFC 5545 recurrence that materialises
exactly one successor on completion.
- Habits and goals — streaks computed from entries (never stored), and
goals that keep exact precision whether the target is 42.195 km or ₹300,000.
- Finance — accounts, categories, transactions, transfers, budgets,
subscriptions, net worth. Money is integer minor units throughout; transfers
are two balanced rows and never inflate income or spending; balances are
derived from the ledger rather than stored.
- Trading journal — trading accounts, strategies, trades, executions,
psychology notes. Entry price, exit price and realised P&L are derived from
executions, so partial fills and scaling in/out are representable. Win rate,
profit factor, expectancy, R-multiple, equity curve and drawdown.
- Identity — email/password with argon2id, optional Google OIDC, an age
gate, versioned consent, session listing and revocation, data export, and
permanent account deletion.
- Email preferences — four categories, opt-in marketing, one-click
unsubscribe with
List-Unsubscribe, suppression, replay-protected tokens.
Documentation
Getting started
pnpm install
cp .env.example .env # then fill in DATABASE_URL and AUTH_SECRET
createdb nestedflow
pnpm db:migrate
pnpm dev
Generate a real secret with openssl rand -base64 48. The application refuses
to start if the environment is incomplete, rather than failing later.
pnpm verify # lint + typecheck + test + build
pnpm test:e2e # production build, real browser
Deliberate limitations
No bank, broker or market-data integration. No payment provider. Email and password
reset go through Resend, but reach every user only once a sending domain is verified —
none is owned yet. No sign-up email verification. No compliance
certification. These require credentials, commercial agreements or approvals
that do not exist, and none of them are designed in as though they did.
Google sign-in is fully implemented but inert without credentials: the routes
fail honestly and the button is not rendered.
This is not financial advice
Nested Flow records what you tell it. It places no orders, fetches no prices, and
connects to no institution. Statistics describe trades you have already
recorded and say nothing about future results.
Design attribution
Visual direction — dark, calm, domain-coloured — is informed by a reference
image supplied by the project owner. Its branding, wordmark, illustrations,
icon set and layout compositions are not reproduced. There are no image
assets in this repository; every visual element is CSS or an inline SVG icon
from an ISC-licensed library. Fonts are self-hosted under the SIL OFL; nothing
is loaded from a third-party origin.
