Skip to content

KimlikDAO/dapp

Repository files navigation

 KimlikDAO dApp

👋 Introduction

Using the KimlikDAO dApp, you can mint your KPass by interacting with the KimlikDAO network and inscribe it on one of the blockchains we support (such as Ethereum, Arbitrum, Mina, etc).

The KimlikDAO dApp is truly decentralized: you can run it locally, deploy it on your own server, or use the reference deployment at kimlikdao.org.

The dApp will connect to the KimlikDAO network nodes and the node discovery will be initiated through the seeed nodes at node.kimlikdao.org, kdao-node.yenibank.org, kdao-node.blinkbridge.xyz. To modify the seed nodes, edit the list in lib/node/network.js.

For blockchain nodes, the dApp has no hardcoded rpc urls and will rely on your wallet's provider.

🧑‍💻 Developer Guide

The KimlikDAO dApp is built with our in-house framework, kastro. Kastro provides a familiar react-like experience yet allows us to build highly optimized and lightweight fontends by pushing as much work as possible to the compile time.

To run the dApp, follow these steps:

  • git clone --recursive https://github.com/KimlikDAO/dapp

  • bun i install the required npm packages

  • bun dev run the dev server

The dApp can also be run in compiled and canary modes. To run the dApp in these modes, we need other tools installed:

# brew dependencies
brew install pngcrush brotli zopfli woff2 webp librsvg
# pip dependencies
pip install fonttools

With these dependencies installed, we can run the dApp in compiled and canary modes:

  • bun compiled compile the required pages and assets
  • bun canary serve the bundle prepared for deployment