This monorepo contains a cross-platform Bitcoin Lightning Cashu wallet with support for web, iOS, and Android.
Supported Cashu NUTS
- 1: Mint public keys
- 2: Keysets and keyset IDs
- 3: Request minting
- 4: Minting tokens
- 5: Melting tokens
- 6: Splitting tokens
- 7: Token spendable check
- 8: Overpaid Lightning fees
- 9: Mint info
This project was bootstrapped with npm create tamagui
The main apps are:
-
expo
(native) -
next
(web) -
packages
shared packages across appsui
includes your custom UI kit that will be optimized by Tamaguiapp
you'll be importing most files fromapp/
features
(don't use ascreens
folder. organize by feature.)provider
(all the providers that wrap the app, and some no-ops for Web.)
-
Install dependencies:
yarn
-
Next.js local dev:
yarn web
To run with optimizer on in dev mode (just for testing, it's faster to leave it off): yarn web:extract
. To build for production yarn web:prod
.
To see debug output to verify the compiler, add // debug
as a comment to the top of any file.
- Expo local dev:
yarn native
If you're installing a JavaScript-only dependency that will be used across platforms, install it in packages/app
:
cd packages/app
yarn add date-fns
cd ../..
yarn
If you're installing a library with any native code, you must install it in expo
:
cd apps/expo
yarn add react-native-reanimated
cd ..
yarn
yarn upgrade-interactive
You can also install the native library inside of packages/app
if you want to get autoimport for that package inside of the app
folder. However, you need to be careful and install the exact same version in both packages. If the versions mismatch at all, you'll potentially get terrible bugs. This is a classic monorepo issue. I use lerna-update-wizard
to help with this (you don't need to use Lerna to use that lib).
You may potentially want to have the native module transpiled for the next app. If you get error messages with Cannot use import statement outside a module
, you may need to use transpilePackages
in your next.config.js
and add the module to the array there.