seb3s/kandesk seb3s/kandesk

  • Stars
    star
    177
  • Rank 215,985 (Top 5 %)
  • Language
    Elixir
  • License
    MIT License
  • Created about 4 years ago
  • Updated almost 3 years ago
Twitter logo Share LinkedIn logo Share Facebook logo Share
seb3s/kandesk
github

seb3s

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Simple Kanban application written in elixir using phoenix liveview

Kandesk

Kandesk is a simple trello-like app that I created for my own needs and for learning elixir & liveview. It has a simple set of features. I use it every day (hosting it on a small raspberry pi3) and it is suitable for individuals or small teams.

Kandesk board

Installation & requirements

Elixir 1.12+ is required to run Kandesk.

To start your Phoenix server:

  • Install dependencies with mix deps.get
  • Create and migrate your database with mix ecto.setup
  • Install Node.js dependencies with cd assets && npm install
  • Start Phoenix endpoint with mix phx.server

Create a first admin user

To be able to connect to the application, a first admin user must be created. This is done by running:

mix run priv/repo/seeds.exs

Then you can connect with "[email protected]" as Email and "admin" as Password. Then you will be able to change everything from within the application, password included ;-)

Avatars

Avatars are currently saved to disk at "/srv/www/kandesk". You need to create this directory with the required rights to be able to save & use avatars with your installation.

Access the application

Now you can visit localhost:4001 from your browser.

Ready to run in production? Please check our deployment guides.

Features set

Kandesk is a fully multilingual application. Please feel free to contribute to the project by submitting a new translation.

Boards:

  • create / update / delete
  • sharable among users with fine grain access control (edit_board?, delete_board?, create_column?, edit_column?, delete_column?, move_column?, create_task?, edit_task?, delete_task?, move_task?, admin_tags?, assoc_tags?)
  • export board content to pseudo xml data

Columns:

  • create / update / delete
  • visibility: a column can be made visible to its creator only
  • columns are sortable via drag & drop
  • duplicate a column
  • move a column to another board
  • export column content to pseudo xml data
  • realtime updates among users viewing the same board
  • cards counter in header

Cards:

  • create / update / delete
  • cards are sortable via drag & drop within and between columns
  • tags association
  • realtime updates among users viewing the same board

Tags:

  • create / update
  • two display modes: large with text or small without
  • new tags can be added
  • tags are sortable to control the order in which they appear on cards
  • realtime updates among users viewing the same board

Account page:

  • page to maintain your personal data: names, avatar, language, timezone, password

Admin area:

  • manage users : simple admin panel to be able to create / update / delete users

Learn more about elixir, phoenix & liveview