Cashu (cashu)

Cashu Wallet

One-liner build & run

docker compose up -d

access at http://localhost:3000 or serve it behind a reverse proxy.

Install the dependencies

npm install

Start the app in development mode (hot-code reloading, error reporting, etc.)

quasar dev

Run unit tests

npm test

Lint the files

npm run lint

Format the files

npm run format

Check translations

Use this to verify non-English translations are in sync with the English source:

npm run i18n:check

Build the app for production

quasar build -m pwa

Capacitor

After updating code, run:

quasar build -m pwa
npx cap copy
npx cap sync
npx cap open android / ios

Regenerate assets:

npx capacitor-assets generate

Customize the configuration

See Configuring quasar.config.js.

Reverse proxy

For Quasar Vue Router with history mode, add this fallback URL to allow refreshes: https://router.vuejs.org/guide/essentials/history-mode.html#HTML5-Mode

More info: https://stackoverflow.com/questions/36399319/vue-router-return-404-when-revisit-to-the-url

Caddyfile:

# CORS snippet by https://kalnytskyi.com/posts/setup-cors-caddy-2/
(cors) {
  @cors_preflight method OPTIONS
  @cors header Origin {args.0}

  handle @cors_preflight {
    header Access-Control-Allow-Origin "{args.0}"
    header Access-Control-Allow-Methods "GET, POST, PUT, PATCH, DELETE"
    header Access-Control-Allow-Headers "Content-Type"
    header Access-Control-Max-Age "3600"
    respond "" 204
  }

  handle @cors {
    header Access-Control-Allow-Origin "{args.0}"
    header Access-Control-Expose-Headers "Link"
  }
}
host.com {
    import cors *
    encode gzip

    header /service-worker.js {
            Service-Worker-Allowed "/"
            Cache-Control "no-cache"
    }

    # SPA root
    root * /usr/share/caddy/cashu.me/

    # quasar vue router fallback history mode
    try_files {path} /index.html

    file_server
}