Reading the repo

Opening the box…

How to install on macOS

we-promise/sure

The personal finance app for everyone (by everyone)

Node.jsRubyRails

Difficulty: Involved
Time: 30 min or more
Stars: ★ 10,807
Activity: Updated this month
License: AGPL-3.0
Open issues: 865
Got it running: Be the first
Looked up: 5 h ago

Saved setup from 5 h ago

Start here

Website ↗sure.amThe project's own site.In the browser ↗Open in GitHub CodespacesThe repo ships a dev container, so nothing to install.

Setup script in the repo

The maintainers included bin/setup. Open it to see how it's meant to be run: bin/setup on GitHub.

Will it work on my device?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Checking for

macOS Windows Linux

Install on your Android / TV device

Sure v0.7.6 — Clearer spending, smarter rules, and better backups · 10/31/2026 ↗

This app runs on the device, not on your macOS computer. Download it, then install it from the computer with adb (turn on ADB debugging in the device's Developer Options first).

sure-v0.7.6.apk

Android app · 73.2 MB · 101 downloads

Download

adb connect <device-ip>:5555
adb install -r "sure-v0.7.6.apk"

Download for macOS

Sure v0.7.6 — Clearer spending, smarter rules, and better backups · 10/31/2026 ↗

Sure_0.7.6_universal.dmg

dmg · Universal · 9.7 MB · 16 downloads · best match

Download

Drag the app into Applications.

curl -LO "https://github.com/we-promise/sure/releases/download/v0.7.6/Sure_0.7.6_universal.dmg"
open "Sure_0.7.6_universal.dmg"

Did you get it running?

No reports for macOS yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Node.js 24runtime
1×Ruby 3.4.9runtime
1×npm package manager
1×bundler package manager
1×Redis service

53× settings in .env

SELF_HOSTED
PORT
SIMPLEFIN_DEBUG_RAW
SIMPLEFIN_INCLUDE_PENDING
SNAPTRADE_OAUTH_CLIENT_ID
SNAPTRADE_OAUTH_CLIENT_SECRETsecretoptional
LUNCHFLOW_DEBUG_RAW
LUNCHFLOW_INCLUDE_PENDING
ONBOARDING_STATE
TWELVE_DATA_API_KEYsecret
OPENAI_ACCESS_TOKENsecret
OPENAI_URI_BASE
OPENAI_MODEL
OIDC_CLIENT_ID
OIDC_CLIENT_SECRETsecret
OIDC_ISSUER
OIDC_REDIRECT_URI
WEBAUTHN_RP_ID
WEBAUTHN_ALLOWED_ORIGINS
LANGFUSE_PUBLIC_KEYsecret
LANGFUSE_SECRET_KEYsecret
LANGFUSE_HOST
AI_DEBUG_MODE
APNS_KEY_IDsecret
APNS_TEAM_ID
APNS_BUNDLE_ID
APNS_PRIVATE_KEY_BASE64secret
SKYLIGHT_AUTHENTICATION
SKYLIGHT_ENABLED
COVERAGEoptional
DISABLE_PARALLELIZATION
SECRET_KEY_BASEsecret
EXCHANGE_RATE_PROVIDER
SECURITIES_PROVIDER
BRAND_FETCH_CLIENT_ID
CHIMNIE_API_KEYsecretoptional
SMTP_ADDRESSoptional
SMTP_PORToptional
SMTP_USERNAMEoptional
SMTP_PASSWORDsecretoptional
SMTP_TLS_ENABLEDoptional
SMTP_TLS_SKIP_VERIFYoptional
EMAIL_SENDER
DB_HOST
DB_PORT
POSTGRES_PASSWORDsecret
POSTGRES_USER
REDIS_URL
APP_DOMAIN
PRODUCT_NAME
BRAND_NAME
POSTHOG_KEYsecret
POSTHOG_HOST

Featured in Zain Finds

See the poster ↗Unreal... a whole personal finance app that got abandoned, and the community just picked i

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/we-promise/sure/badge.svg)](https://gitmanual.com/we-promise/sure)

Good to know

Dockerfile available (base image: registry.docker.com/library/ruby:$RUBY_VERSION-slim).
Dev Container config found — you can open it in VS Code Dev Containers or GitHub Codespaces for a zero-setup environment.
Setup script found: bin/setup.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: desktop/package.json, desktop/src-tauri/Cargo.toml, mobile/pubspec.yaml

package.json scripts (8)

style:checkbiome check
style:fixbiome check --write
lintbiome lint
lint:fixbiome lint --write
format:checkbiome format
formatbiome format --write
tokens:buildnode bin/tokens.mjs
tokens:checknode bin/tokens.mjs && git diff --quiet -- app/assets/tailwind/sure-design-system/_generated.css

Files we read (16)

.devcontainer/devcontainer.json

.env.example

.env.local.example

.env.test.example

.github/workflows/chart-ci.yml

.github/workflows/ci.yml

.github/workflows/flutter-build.yml

.github/workflows/ios-testflight.yml

.github/workflows/mobile-build.yml

.github/workflows/mobile-ci.yml

.ruby-version

CONTRIBUTING.md

Dockerfile

Gemfile

README.md

package.json

Branch main · 7,706 files in the repo