You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
John Molakvoæ 68964bc37a
chore: update workflows from templates
Signed-off-by: John Molakvoæ <>
8 hours ago
.github chore: update workflows from templates 8 hours ago
.tx [tx-robot] Update transifex configuration 8 months ago
appinfo Add Nextcloud 28 support 2 weeks ago
composer perf(autoloader): Use Composer's authoritative classmap 4 months ago
css feat(contacts): implement final design enhancements from mockups 4 weeks ago
img Change fill to white to match other icons. 1 year ago
l10n Fix(l10n): Update translations from Transifex 22 hours ago
lib Fix Don't show groups in share placeholder if group sharing is disabled #2242 1 week ago
src Merge pull request #3422 from nextcloud/enhanc/hide-empty-properties 13 hours ago
templates Remove OC_Util::isIe() 1 year ago
tests prioritize local users in mastodon avatar download, fixes #3210 4 months ago
.eslintrc.js Bump @nextcloud/eslint-config from 6.1.2 to 8.1.2 7 months ago
.gitignore Adjust ignore lists 10 months ago
.nextcloudignore Adjust ignore lists 10 months ago
.npmignore Vue cleanup and init 5 years ago
.php-cs-fixer.dist.php Reinstall version so php-cs-fixer is up to date 10 months ago v5.1.0 4 months ago
COPYING Copyright fix 5 years ago
Makefile Build package using krankerl 12 months ago add composer install to readme 1 week ago
babel.config.js 4.0.0-alpha.0 2 years ago
composer.json feat(deps): Revive PHP7.4 support 3 months ago
composer.lock chore(deps-dev): bump phpunit/phpunit from 9.6.7 to 9.6.8 3 weeks ago
jest.config.js perf(bundles): migrate nc-vue imports 1 month ago
krankerl.toml Build package using krankerl 12 months ago
package-lock.json Merge pull request #3419 from nextcloud/dependabot/npm_and_yarn/nextcloud/auth-2.1.0 6 days ago
package.json Merge pull request #3419 from nextcloud/dependabot/npm_and_yarn/nextcloud/auth-2.1.0 6 days ago
phpunit.xml Adjust phpunit config in main 1 year ago
stylelint.config.js Bump deps and use npm7 2 years ago
tsconfig.json New member button and virtual list 2 years ago
webpack.config.js enh: Add crop component for contact picture 1 month ago

Nextcloud Contacts

Downloads Code coverage Dependabot status

A contacts app for Nextcloud. Easily sync contacts from various devices with your Nextcloud and edit them online.

This app only support vCard 3.0 and 4.0. This app is compatible with the same browsers as server except IE!

💙 🎉 Why is this so awesome?

  • 🚀 Integration with other Nextcloud apps! Currently Mail and Calendar more to come.
  • 🎉 Never forget a birthday! You can sync birthdays and other recurring events with your Nextcloud Calendar.
  • 👥 Sharing of address books! You want to share your contacts with your friends or coworkers? No problem!
  • 🙈 Were not reinventing the wheel! Based on the great and open SabreDAV library.


🛠️ Installation

The app is distributed through the app store and you can install it right from your Nextcloud installation.

Release tarballs are hosted at

📡 Support

If you need assistance or want to ask a question about Contacts, you are welcome to ask for support in our forums. If you have found a bug, feel free to open a new Issue on GitHub. Keep in mind, that this repository only manages the frontend. If you find bugs or have problems with the CardDAV-Backend, you should ask the team at Nextcloud server for help!

Could you add XXX property?

This is a complicated answer. We did not invent the way contacts works. We are following the official vCard format. This format include a predefined set of properties that other applications/devices supports too (Android, iOS, Windows, Gnome...). Adding a custom property would just make it compatible with Nextcloud and will not be understood by any other clients and make it complicated for us to ensure its sustainability over time. Long story short, we suggest you use the Notes field to add your custom data :)

If you'd like to join, just go through the issue list and fix some. :)

Build the app

# set up and build for production
composer install
npm ci
npm run build

# install dependencies
composer install
npm ci

# build for dev and watch changes
npm run watch

# build for dev
npm run dev

# build for production with minification
npm run build

Running tests

You can run all front-end tests by using:

# run tests once
npm run test

# run tests continuously after every change
npm run test:watch

✌️ Code of conduct

The Nextcloud community has core values that are shared between all members during conferences, hackweeks and on all interactions in online platforms including Github and Forums. If you contribute, participate or interact with this community, please respect our shared values. 😌

❤️ How to create a pull request

This guide will help you get started: