You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Nextcloud bot 3c6c576f4e
[tx-robot] updated from transifex
1 day ago
.github Update stale.yml 7 months ago
.tx Fix tx config 1 year ago
appinfo Bump versions on master 1 month ago
css Fix sortable placehodler in compact mode 5 months ago
docs Add date format to If-Modified-Since documentation (#1196) 3 weeks ago
img Share with circles 5 months ago
js Bump webpack from 4.39.3 to 4.40.2 in /js 1 week ago
l10n [tx-robot] updated from transifex 1 day ago
lib Probably a better method to solve the update card title issue. 3 weeks ago
templates Remove collections label in sidebar 4 months ago
tests Fix ACL and archived REST endpoints (#1111) 2 months ago
.codecov.yml Test codecov fix 2 years ago
.drone.yml Bump phpunit 1 month ago
.eslintignore Fix eslint errors 1 year ago
.eslintrc.yml Fix eslint errors 1 year ago
.gitignore ignore .idea 5 months ago
.travis.yml Bump phpunit 1 month ago
CHANGELOG.md Update CHANGELOG 1 month ago
LICENSE Update files in root 2 years ago
Makefile Fix deps in Makefile 1 year ago
README.md Update README.md 5 months ago
composer.json Update christophwurst/nextcloud requirement from ^15.0 to ^16.0 1 month ago
krankerl.toml Add dependencies to info.xml 10 months ago
mkdocs.yml Add user docs to the navigation 6 months ago
run-eslint.sh Ignore vue files from eslint for now 6 months ago

README.md

Deck

Build Status CodeCov Codacy Badge Scrutinizer Code Quality

Deck is a kanban style organization tool aimed at personal planning and project organization for teams integrated with Nextcloud.

  • :inbox_tray: Add your tasks to cards and put them in order
  • :page_facing_up: Write down additional notes in markdown
  • :bookmark: Assign labels for even better organization
  • :busts_in_silhouette: Share with your team, friends or family
  • :family: Integrates with the Circles app!
  • :paperclip: Attach files and embed them in your markdown description
  • :speech_balloon: Discuss with your team using comments
  • :zap: Keep track of changes in the activity stream
  • :rocket: Get your project organized

Deck - Manage cards on your board

Installation/Update

This app is supposed to work on the two latest Nextcloud versions.

Install latest release

You can download and install the latest release from the Nextcloud app store

Install from git

If you want to run the latest development version from git source, you need to clone the repo to your apps folder:

git clone https://github.com/nextcloud/deck.git
cd deck
make install-deps
make build

Please make sure you have installed the following dependencies: make, which, tar, npm, curl, composer

Install the nightly builds

Instead of setting everything up manually, you can just download the nightly builds instead. These builds are updated every 24 hours, and are pre-configured with all the needed dependencies.

Developing

PHP

Nothing to prepare, just dig into the code.

JavaScript

Deck requires running a make build-js to install npm dependencies and build the JavaScript code using webpack. While developing you can also use make watch to rebuild everytime the code changes.

Running tests

You can use the provided Makefile to run all tests by using:

make test

Documentation

The documentation for our REST API can be found at https://deck.readthedocs.io/en/latest/API/

Contribution Guidelines

Please read the Code of Conduct. This document offers some guidance to ensure Nextcloud participants can cooperate effectively in a positive and inspiring atmosphere, and to explain how together we can strengthen and support each other.

For more information please review the guidelines for contributing to this repository.

Apply a license

All contributions to this repository are considered to be licensed under the GNU AGPLv3 or any later version.

Contributors to the Deck app retain their copyright. Therefore we recommend to add following line to the header of a file, if you changed it substantially:

@copyright Copyright (c) <year>, <your name> (<your email address>)

For further information on how to add or update the license header correctly please have a look at our licensing HowTo.

Sign your work

We use the Developer Certificate of Origin (DCO) as a additional safeguard for the Nextcloud project. This is a well established and widely used mechanism to assure contributors have confirmed their right to license their contribution under the project’s license. Please read developer-certificate-of-origin. If you can certify it, then just add a line to every git commit message:

  Signed-off-by: Random J Developer <random@developer.example.org>

Use your real name (sorry, no pseudonyms or anonymous contributions). If you set your user.name and user.email git configs, you can sign your commit automatically with git commit -s. You can also use git aliases like git config --global alias.ci 'commit -s'. Now you can commit with git ci and the commit will be signed.