diff --git a/docs/API.md b/docs/API.md deleted file mode 100644 index 237b5c3..0000000 --- a/docs/API.md +++ /dev/null @@ -1,20 +0,0 @@ - -Previous docs for the API are [here](https://actualbudget.com/docs/developers/using-the-API/). The API is currently being improved. Previously, the API connected to an existing running instance of Actual. Now the API is bundled and fully isolated, capable of running all of Actual itself. Setting up the API is different because of this. - -You need to call `init` and pass it the directory where your files live. Call `load-budget` to load the file you want to work on. After that, you can use the same API as before. - -Example: - -```js -let actual = require('@actual-app/api'); - -await actual.init({ - config: { - dataDir: join(__dirname, 'user-files') - } -}); - -await actual.internal.send('load-budget', { id: 'My-Finances' }); - -await actual.getAccounts(); -``` diff --git a/docs/Building-for-Windows.md b/docs/Building-for-Windows.md deleted file mode 100644 index 1736c15..0000000 --- a/docs/Building-for-Windows.md +++ /dev/null @@ -1,18 +0,0 @@ -# How to build browser for Windows -Many of the build scripts are bash scripts and not natively invokable in Windows. To solve this, you can build the project using Git Bash. -1. Install [Git & Git Bash for Windows](https://git-scm.com/downloads) -2. Install Node v16.x (latest version 17.x does not work due to issue with crypto package) -3. Clone this repo -4. From the root of this repo, run `sh` to launch a bash shell -5. From inside the bash shell, run `yarn install` -6. From still inside the shell, run `yarn start:browser` -7. Open your browser to `localhost:3001` - -# How to build electron for Windows -1. Follow steps 1 - 5 above. -2. Run `yarn start` -3. If you get an error from electron, run `yarn rebuild-electron` and rerun `yarn start`; - -## rsync: command not found -If you run into this error, you will need to install the rsync binary to Git Bash. Follow the [directions here](https://prasaz.medium.com/add-rsync-to-windows-git-bash-f42736bae1b3). When you get to the final step - installing the libxxhash dll - rename the dll from `msys-xxhash-0.8.0.dll` to `msys-xxhash-0.dll` - diff --git a/docs/releasing.md b/docs/releasing.md deleted file mode 100644 index 8da8ed5..0000000 --- a/docs/releasing.md +++ /dev/null @@ -1,44 +0,0 @@ -# How to cut a release - -In the open-source version of Actual, all updates go through npm. There are two libraries: - -* `@actual-app/api`: The API for the underlying functionality. This includes the entire backend of Actual, meant to be used with node. -* `@actual-app/web`: A web build that will serve the app with a web frontend. This includes both the frontend and backend of Actual. It includes the backend as well because it's built to be used as a Web Worker. - -Both the API and web libraries are versioned together. This may change in the future, but because the web library also brings along its own backend it's easier to maintain a single version for now. That makes it clear which version the backend is regardless of library. - -## Releasing `@actual-app/api` - -This generates a bundle for the API: - -``` -cd packages/loot-core -yarn build:api -``` - -The built files live in `lib-dist`, so we need to copy them to the API package: - -``` -cp lib-dist/bundle.api* ../api/app -``` - -Next, bump the version on package.json. Finally, publish it: - -``` -npm publish -``` - -## Releasing `@actual-app/web` - -In the root of `actual` (not just `desktop-client`), run this: - -``` -./bin/package-browser -``` - -This will compile both the backend and the frontend into a single directory in `packages/desktop-client/build`. This directory is all the files that need to be published. After bumping the version, publish `desktop-client`: - -``` -cd packages/desktop-client -npm publish -```