9fb6876f3b
* [AI] sync-server: use workspace reference for @actual-app/crdt Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * Update build script in sync-server package to use TypeScript's build mode * Package electron * [AI] crdt: add conditional exports so Node can load the built bundle Before this change the root exports entry pointed at `./src/index.ts`, so any pure-Node consumer (notably the sync server that Electron forks as a utility process) failed to import `@actual-app/crdt` — Node can't execute TypeScript source directly. Sync-server had been masking this by pulling `@actual-app/crdt@npm:2.1.0` where `publishConfig.exports` resolves to `./dist/index.js`; once sync-server switched to `workspace:*`, the Functional Desktop App CI job timed out waiting for the sync server to boot. Switch to conditional exports in the same shape `@actual-app/api` already uses: - `types` → `./dist/index.d.ts` for TypeScript tooling - `development` → `./src/index.ts` for Vite/Vitest (HMR, fast feedback) - `default` → `./dist/index.js` for Node runtime Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This is the main project to run Actual, a local-first personal finance tool. It comes with the latest version of Actual, and a server to persist changes and make data available across all devices.
Getting Started
Actual is a local-first personal finance tool. It is 100% free and open-source, written in NodeJS, it has a synchronization element so that all your changes can move between devices without any heavy lifting.
If you are interested in contributing, or want to know how development works, see our contributing document we would love to have you.
Want to say thanks? Click the ⭐ at the top of the page.
Using the CLI tool
Node.js v22 or higher is required for the @actual-app/sync-server npm package
Install globally with npm:
npm install --location=global @actual-app/sync-server
After installing, you can execute actual-server commands directly in your terminal.
Usage
actual-server [options]
Available options
| Command | Description |
|---|---|
-h or --help |
Print this list and exit. |
-v or --version |
Print this version and exit. |
--config |
Path to the config file. |
--reset-password |
Reset your password |
Examples
Run with default configuration
actual-server
Run with custom configuration
actual-server --config ./config.json
Reset your password
actual-server --reset-password
Documentation
We have a wide range of documentation on how to use Actual. This is all available in our Community Documentation, including topics on installing, Budgeting, Account Management, Tips & Tricks and some documentation for developers.
Feature Requests
Current feature requests can be seen here. Vote for your favorite requests by reacting 👍 to the top comment of the request.
To add new feature requests, open a new Issue of the "Feature Request" type.