Danban

A Kanban board backed by a DAML Ledger, inspired by Trello and based on react-kanban.

Check out the live website

Features

• It has most of the features available on Trello, like creating and editing new cards, dragging around cards and so on.
• Supports GitHub flavored markdown, which enables stuff like headings and checklists on the cards.
• Works great on touch devices.
• Public and private boards, with sharing functionality
• Fully backed by a DAML Ledger

Tech stack

• React
• Redux
• React-beautiful-dnd
• Sass
• Webpack
• Babel
• Express
• Passport
• DAML

Development

You need

• the DAML SDK
• A Google Cloud project with API access for Google Auth
• Node.js v12

Clone & Install Dependencies

git clone https://github.com/digital-asset/danban.git

cd danban

npm install

Start DAML Sandbox

cd danban

daml start --sandbox-option="--ledgerid=danban" --sandbox-option="-w"

Set up Environment

You need auth credentials for the Google sign in. You need to create a file with the name .env in the root directory with the following variables:

GOOGLE_CLIENT_ID
GOOGLE_CLIENT_SECRET

# Has to be True for Sandbox mode
USE_SANDBOX="True"

# Has to be port 1337
ROOT_URL=http://127.0.0.1:1337

Run in dev mode

npm run build:watch
npm run serve:watch

Run in test mode

npm run build
npm run serve

Run in prod mode

npm run build:prod
npm run serve:prod

Run on Project DABL

To run on DABL, you need a DABL Ledger with the DAML model deployed. You also need the refresh cookie for the ledger admin account. Then add the following two variables to your environment and remove USE_SANDBOX:

REFRESH_COOKIE="__DABL_SESSION={YOUR_COOKIE}"
DABL_LEDGER="{DABL_LEDGER_ID}"