📇 Contacts app for Nextcloud
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github Update issue_template.md Apr 18, 2017
.tx Fix tx config Feb 12, 2018
appinfo occ compliance, fix #662 Oct 3, 2018
css Textarea note fixes and resize Oct 5, 2018
img Scour social Oct 1, 2018
l10n [tx-robot] updated from transifex Oct 20, 2018
lib Vue cleanup and init Jul 11, 2018
src Fix varname Oct 5, 2018
templates Merge branch 'master' of https://github.com/nextcloud/contacts into vue Sep 28, 2018
tests Details properties update and addressbook template Aug 8, 2018
.babelrc.js Merge branch 'vue' of https://github.com/nextcloud/contacts into vue-… Sep 10, 2018
.editorconfig Vue cleanup and init Jul 11, 2018
.eslintrc.js Trailing comma Sep 28, 2018
.gitignore Cleanup Sep 28, 2018
.npmignore Vue cleanup and init Jul 11, 2018
.stylelintrc.js Update config files names Sep 10, 2018
.travis.yml Cleanup Oct 3, 2018
COPYING Added agplv3 license file. Oct 20, 2016
Makefile Cleanup Sep 28, 2018
README.md Rebase Sep 28, 2018
package-lock.json Npm update, cdav and translations fixes Oct 5, 2018
package.json Npm update, cdav and translations fixes Oct 5, 2018
phpunit.integration.xml add common makefile, make it possible to run tests and build package … Mar 27, 2016
phpunit.xml add common makefile, make it possible to run tests and build package … Mar 27, 2016
webpack.common.js Fix date formating and default date value + deps Oct 1, 2018
webpack.dev.js Vue cleanup and init Jul 11, 2018
webpack.prod.js Vue cleanup and init Jul 11, 2018

README.md

Nextcloud Contacts

Downloads irc Build Status Code coverage

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

💙 🎉 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 Adressbooks! 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!

Maintainers:

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

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.

  1. Download
  2. Extract the tar archive to 'path-to-nextcloud/apps'
  3. Navigate to »Apps«, choose the category »Productivity«, find the Contacts app and enable it.

The nightly builds are provided by Portknox.net

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: