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!
- 🚀 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.
The app is distributed through the app store and you can install it right from your Nextcloud installation.
Release tarballs are hosted at https://github.com/nextcloud-releases/contacts/releases.
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!
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. :)
# 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
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
The screenshots referenced in appinfo/info.xml live in screenshots/ and are generated with Playwright against a running Nextcloud server with the app enabled. The script recreates a demo user jane and logs in as admin/admin to do so (override with NC_ADMIN_USER and NC_ADMIN_PASSWORD).
PLAYWRIGHT_BASE_URL=https://nextcloud.local npm run screenshots
Captured files get the major.minor version of appinfo/info.xml as suffix (e.g. contacts-8.10.png) and the screenshot URLs in appinfo/info.xml and this README are pointed at them, so the App Store cache picks up the new images. The App Store screenshots workflow regenerates them on release pull requests of a new minor or major version.
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. 😌
This guide will help you get started:
Commits in this repository follow the Conventional Commits specification.