/contacts

πŸ“‡ Contacts app for Nextcloud

Primary LanguageJavaScriptGNU Affero General Public License v3.0AGPL-3.0

Nextcloud Contacts

Downloads Codacy Badge Code coverage Dependabot status irc

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!
  • πŸ™ˆ We’re not reinventing the wheel! Based on the great and open SabreDAV library.

πŸ› οΈ Installation

In your Nextcloud, simply navigate to "Apps", choose the category "Organization", find the Contacts app and enable it. Then open the Contacts app from the app menu.

πŸ“‘ Support

If you need assistance or want to ask a question about Contacts, you are welcome to ask for support in our Forums or the IRC-Channel. 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 :)

Maintainers:

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

Build the app

# set up and build for production
make

# install dependencies
make dev-setup

# build for dev and watch changes
make watch-js

# build for dev
make build-js

# build for production with minification
make build-js-production

Running tests

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

make test

✌️ 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:

Thanks