Skip to content

colinfran/kwallet

Repository files navigation

kwallet

A non-custodial Kaspa wallet app for iOS and Android

Project Status Update:

As of now, development on kwallet has been paused. The project is open for anyone interested in continuing its development. Feel free to contribute and take it forward.



Donations accepted!




Frameworks

Kaspa Expo React Badge React Native NodeJS Express.js Digital Ocean Badge



local development

set up:

git clone https://github.com/colinfran/kwallet.git
cd kwallet
yarn install

cd server
yarn install
cd ..

Once all packages have been installed, run the following commands

cp .env-example .env
cp ./server/.env-example ./server/.env

After running these commands, go into the root .env file and add your computer's network IP. This is needed for when running yarn run dev. When you run this command, it will run with your local server. When testing with local server and an external device, the device needs to be able to send requests to the local server.


run app with local server

To run the Expo app with local server, you will need to have two terminal instances open.

In the first terminal instance, run the server:

yarn run server

In the second instance, run the expo app:

yarn run app:dev

run app with production server

To run the Expo app with production server, in a single terminal run:

yarn run app:prod

NOTE THAT IF YOU WANT TO RUN APP WITH PRODUCTION SERVER, YOU WILL NEED TO REACH OUT TO @colinfran FOR A PRODUCTION SERVER API KEY.


3rd party services

Listed below are the free 3rd party services used to help keep the app running smoothly.

Service Product
Bug Tracking and Error Reporting Sentry.io
Uptime Monitoring BetterUptime
Zoho Email Services Zoho

kwallet website

The Kwallet website is hosted on GitHub Pages. The website code can be found here.

To maximize bandwidth for the API server, all static files, web pages, images, etc are hosted by GitHub Pages.

To deploy the website you need admin privledges to the repo. To deploy website to github pages, run:

yarn run deploy-website

Under the hood, the kwallet website files are bundled and pushed up to a specific branch: "gh-pages". This branch is what is used to host the website.

The root domain (kwallet.app) is hosted via GitHub Pages. The api subdomain (api.kwallet.app) is hosted via DigitalOcean. All this was set up through the DNS records. Must have admin access to be able to make changes to DNS records.