{"id":13403097,"url":"https://github.com/nextcloud/deck","last_synced_at":"2025-05-14T09:11:39.146Z","repository":{"id":37334586,"uuid":"79368515","full_name":"nextcloud/deck","owner":"nextcloud","description":"🗂 Kanban-style project \u0026 personal management tool for Nextcloud, similar to Trello","archived":false,"fork":false,"pushed_at":"2025-05-11T03:50:43.000Z","size":138492,"stargazers_count":1277,"open_issues_count":627,"forks_count":284,"subscribers_count":49,"default_branch":"main","last_synced_at":"2025-05-11T04:19:56.895Z","etag":null,"topics":["cards","deck","hacktoberfest","nextcloud","organization","selfhosted","team"],"latest_commit_sha":null,"homepage":"https://apps.nextcloud.com/apps/deck","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nextcloud.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-01-18T18:07:35.000Z","updated_at":"2025-05-11T00:41:50.000Z","dependencies_parsed_at":"2023-11-14T08:40:12.029Z","dependency_job_id":"2ab52ee6-b43f-46ff-a7af-da38412e65b2","html_url":"https://github.com/nextcloud/deck","commit_stats":{"total_commits":5700,"total_committers":157,"mean_commits":36.30573248407644,"dds":0.6871929824561404,"last_synced_commit":"13d6a79b1f8abb5ab65252d1fdb04a2fc6eab0ef"},"previous_names":[],"tags_count":180,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Fdeck","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Fdeck/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Fdeck/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Fdeck/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nextcloud","download_url":"https://codeload.github.com/nextcloud/deck/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254110374,"owners_count":22016391,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cards","deck","hacktoberfest","nextcloud","organization","selfhosted","team"],"created_at":"2024-07-30T19:01:25.367Z","updated_at":"2025-05-14T09:11:39.094Z","avatar_url":"https://github.com/nextcloud.png","language":"JavaScript","readme":"\u003c!--\n  - SPDX-FileCopyrightText: 2016 Nextcloud GmbH and Nextcloud contributors\n  - SPDX-License-Identifier: AGPL-3.0-or-later\n--\u003e\n# Deck\n\n[![Build Status](https://travis-ci.org/nextcloud/deck.svg?branch=main)](https://travis-ci.org/nextcloud/deck) [![CodeCov](https://codecov.io/github/nextcloud/deck/coverage.svg?branch=main)](https://codecov.io/github/nextcloud/deck) [![Codacy Badge](https://api.codacy.com/project/badge/Grade/e403f723f42a4abd93b2cfe36cbd7eee)](https://www.codacy.com/app/juliushaertl/deck?utm_source=github.com\u0026amp;utm_medium=referral\u0026amp;utm_content=nextcloud/deck\u0026amp;utm_campaign=Badge_Grade) [![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/nextcloud/deck/badges/quality-score.png?b=main)](https://scrutinizer-ci.com/g/nextcloud/deck/?branch=main) [![#nextcloud-deck](https://img.shields.io/badge/IRC-%23nextcloud--deck%20on%20freenode-blue.svg)](https://webchat.freenode.net/?channels=nextcloud-deck) [![REUSE status](https://api.reuse.software/badge/github.com/nextcloud/deck)](https://api.reuse.software/info/github.com/nextcloud/deck)\n\n\nDeck is a kanban style organization tool aimed at personal planning and project organization for teams integrated with Nextcloud.\n\n- Add your tasks to cards and put them in order\n- Write down additional notes in markdown\n- Assign labels for even better organization\n- Share with your team, friends or family\n- Integrates with the [Circles](https://github.com/nextcloud/circles) app!\n- Attach files and embed them in your markdown description\n- Discuss with your team using comments\n- Keep track of changes in the activity stream\n- Get your project organized\n\n![Deck - Manage cards on your board](http://download.bitgrid.net/nextcloud/deck/screenshots/1.0/Deck-2.png)\n\n### Mobile apps\n\n- [Nextcloud Deck app for Android](https://github.com/stefan-niedermann/nextcloud-deck) - It is available in [F-Droid](https://f-droid.org/de/packages/it.niedermann.nextcloud.deck/) and the [Google Play Store](https://play.google.com/store/apps/details?id=it.niedermann.nextcloud.deck.play)\n- [Nextcloud Deck app for iOS](https://github.com/StCyr/deck-react-native) - It is available in [Apple App store](https://apps.apple.com/ml/app/nextcloud-deck/id1570892788)\n\n### 3rd-Party Integrations\n\n- [trello-to-deck](https://github.com/maxammann/trello-to-deck) - Migrates cards from Trello\n- [mail2deck](https://github.com/newroco/mail2deck) - Provides an \"email in\" solution\n- [A-deck](https://github.com/leoossa/A-deck) - Chrome Extension that allows to create new card in selected stack based on current tab\n- [QOwnNotes](https://github.com/pbek/QOwnNotes) - Quickly creates cards and links to them in Markdown notes\n\n## Installation/Update\n\nThe app can be installed through the app store within Nextcloud. You can also download the latest release from the [release page](https://github.com/nextcloud-releases/deck/releases).\n\n## Performance limitations\n\nDeck is not yet ready for intensive usage.\nA lot of database queries are generated when the number of boards, cards and attachments is high.\nFor example, a user having access to 13 boards, with each board having on average 100 cards,\nand each card having on average 5 attachments,\nwould generate 6500 database queries when doing the file related queries\nwhich would increase the page loading time significantly.\n\nImprovements on Nextcloud server and Deck itself will improve the situation.\n\n## Developing\n\nThere are multiple ways to develop on Deck. As you will need a Nextcloud server running, the individual options are described below.\n\n### General build instructions\n\nGeneral build instructions for the app itself are the same for all options.\n\nTo build you will need to have [Node.js](https://nodejs.org/en/) and [Composer](https://getcomposer.org/) installed.\n\n- Install PHP dependencies: `composer install --no-dev`\n- Install JS dependencies: `npm ci`\n- Build JavaScript for the frontend\n    - Development build `npm run dev`\n    - Watch for changes `npm run watch`\n    - Production build `npm run build`\n\n### Faster frontend developing with HMR\n\nYou can enable HMR (Hot module replacement) to avoid page reloads when working on the frontend:\n\n1. ☑️ Install and enable [`hmr_enabler` app](https://github.com/nextcloud/hmr_enabler)\n2. 🏁 Run `npm run serve`\n3. 🌍 Open the normal Nextcloud server URL (not the URL given by above command)\n\n### GitHub Codespaces / VS Code devcontainer\n\n- Open code spaces or the repository in VS Code to start the dev container\n- The container will automatically install all dependencies and build the app\n- Nextcloud will be installed from the master development branch and be available on a port exposed by the container\n\n### Docker: Simple app development container\n\n- Fork the app\n- Clone the repository: `git clone https://github.com/nextcloud/deck.git`\n- Go into deck directory: `cd deck`\n- Build the app as described in the general build instructions\n- Run Nextcloud development container and mount the apps source code into it\n\n```\ndocker run --rm \\\n    -p 8080:80 \\\n    -v $PWD:/var/www/html/apps-extra/deck \\\n    ghcr.io/juliushaertl/nextcloud-dev-php81:latest\n```\n\n### Full Nextcloud development environment\n\nYou need to setup a [development environment](https://docs.nextcloud.com/server/latest/developer_manual//getting_started/devenv.html) of the current Nextcloud version. You can also alternatively install \u0026 run the [nextcloud docker container](https://github.com/juliushaertl/nextcloud-docker-dev).\nAfter the finished installation, you can clone the deck project directly in the `/[nextcloud-docker-dev-dir]/workspace/server/apps/` folder.\n\n### Running tests\nYou can use the provided Makefile to run all tests by using:\n\n    make test\n\n#### Running behat integration tests\n\nWithin `tests/integration/` run `composer install` and then choose one of the two options:\n- Run tests with a local php server: `bash run.sh`\n- Run against an existing Nextcloud installation: `BEHAT_SERVER_URL=http://nextcloud.local ./vendor/bin/behat --colors features/decks.feature`\n\n### Documentation\n\nThe documentation for our REST API can be found at https://deck.readthedocs.io/en/latest/API/\n\n## Contribution Guidelines\n\nPlease read the [Code of Conduct](https://nextcloud.com/community/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.\n\nFor more information please review the [guidelines for contributing](https://github.com/nextcloud/server/blob/master/.github/CONTRIBUTING.md) to this repository.\n\n### Apply a license\n\nAll contributions to this repository are considered to be licensed under\nthe GNU AGPLv3 or any later version.\n\nContributors to the Deck app retain their copyright. Therefore we recommend\nto add following line to the header of a file, if you changed it substantially:\n\n```\n@copyright Copyright (c) \u003cyear\u003e, \u003cyour name\u003e (\u003cyour email address\u003e)\n```\n\nFor further information on how to add or update the license header correctly please have a look at [our licensing HowTo][applyalicense].\n\n### Sign your work\n\nWe use the Developer Certificate of Origin (DCO) as a additional safeguard\nfor the Nextcloud project. This is a well established and widely used\nmechanism to assure contributors have confirmed their right to license\ntheir contribution under the project's license.\nPlease read [developer-certificate-of-origin][dcofile].\nIf you can certify it, then just add a line to every git commit message:\n\n````\n  Signed-off-by: Random J Developer \u003crandom@developer.example.org\u003e\n````\n\nUse your real name (sorry, no pseudonyms or anonymous contributions).\nIf you set your `user.name` and `user.email` git configs, you can sign your\ncommit automatically with `git commit -s`. You can also use git [aliases](https://git-scm.com/book/tr/v2/Git-Basics-Git-Aliases)\nlike `git config --global alias.ci 'commit -s'`. Now you can commit with\n`git ci` and the commit will be signed.\n\n[dcofile]: https://github.com/nextcloud/server/blob/master/contribute/developer-certificate-of-origin\n[applyalicense]: https://github.com/nextcloud/server/blob/master/contribute/HowToApplyALicense.md\n","funding_links":[],"categories":["Apps","JavaScript"],"sub_categories":["Official"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnextcloud%2Fdeck","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnextcloud%2Fdeck","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnextcloud%2Fdeck/lists"}