xpenser
Open-source, self-hosted ready personal income and expense tracking that initially demonstrates what can be built with Cleverbrush Framework: typed contracts, schema-driven forms, observable services, and connected app workflows.
Useful finance workflows first
xpenser is a working app, not a static showcase. The demo covers the product surfaces a user expects from a finance tracker while keeping the implementation open-source and small enough to inspect or self-host, including multiple currencies and Frankfurter-backed automatic conversion.
Dashboard summaries
Daily, weekly, monthly, quarterly, and yearly summaries keep income, expenses, net totals, and trends visible.
Transaction tracking
Record income, expenses, refunds, and reversals with category, note, date, and currency context.
Multi-currency conversion
Use multiple transaction currencies with automatic conversion to your default currency through Frankfurter rates.
Period reports
Reports compare current activity with previous periods and previous-year baselines.
Personal setup
Preferences cover default currency, favorite transaction currencies, time zone, API keys, and Telegram bot linking.
Mobile-friendly interface
Responsive screens keep dashboard, transaction, and setup workflows usable on phones and desktops.
Built to show how Cleverbrush pieces fit together
The current version is initially a demonstrator of possibilities: a single app path that exercises Cleverbrush contracts, server handlers, generated clients, schema-backed React forms, auth, Telegram bot integration, an MCP server, logs, telemetry, and deployment-ready configuration for self-hosting.
Schema-first contracts
Shared schemas describe validation, OpenAPI output, React forms, and typed client contracts from one source.
Typed full-stack flow
The same contract powers the server handlers, generated client calls, auth metadata, and cache tags.
Auth-aware APIs
Passport sign-in, API keys, and protected endpoint metadata demonstrate framework-level auth integration.
Observable runtime
OpenTelemetry, structured logs, and typed environment parsing show how production behavior is wired in.
Connected entry points
The app exposes normal product UI and integration paths for agents, services, and external clients.
API keys
Create durable keys for typed client access.
MCP server
Expose dashboard, category, and transaction data through tool calls.
Telegram bot
Link Telegram and use bot-driven finance workflows alongside the web UI.
Telemetry
Trace web, API, and integration paths through SigNoz.
Open the demonstrator
Sign in to use the app, or review the framework docs behind the contracts, forms, APIs, and telemetry for an open-source, self-hosted ready setup.