{"id":13402086,"url":"https://github.com/nextcloud/contacts","last_synced_at":"2025-05-15T01:09:49.018Z","repository":{"id":37444909,"uuid":"71393664","full_name":"nextcloud/contacts","owner":"nextcloud","description":"📇 Contacts app for Nextcloud","archived":false,"fork":false,"pushed_at":"2025-05-09T00:41:11.000Z","size":58033,"stargazers_count":584,"open_issues_count":404,"forks_count":183,"subscribers_count":33,"default_branch":"main","last_synced_at":"2025-05-09T01:32:20.262Z","etag":null,"topics":["carddav","contacts","hacktoberfest","nextcloud","open-source","vcard"],"latest_commit_sha":null,"homepage":"https://apps.nextcloud.com/apps/contacts","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":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-10-19T19:49:40.000Z","updated_at":"2025-05-09T00:41:12.000Z","dependencies_parsed_at":"2024-01-06T04:25:57.589Z","dependency_job_id":"5b7e2c2b-8301-432b-96f2-48a6df1cb660","html_url":"https://github.com/nextcloud/contacts","commit_stats":{"total_commits":4900,"total_committers":124,"mean_commits":"39.516129032258064","dds":0.7240816326530612,"last_synced_commit":"e8b0cae9f2dd2d37515464a0cc97c59d5ebdb028"},"previous_names":[],"tags_count":128,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Fcontacts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Fcontacts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Fcontacts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Fcontacts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nextcloud","download_url":"https://codeload.github.com/nextcloud/contacts/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254254043,"owners_count":22039792,"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":["carddav","contacts","hacktoberfest","nextcloud","open-source","vcard"],"created_at":"2024-07-30T19:01:11.385Z","updated_at":"2025-05-15T01:09:44.009Z","avatar_url":"https://github.com/nextcloud.png","language":"JavaScript","readme":"\u003c!--\n  - SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors\n  - SPDX-FileCopyrightText: 2015-2016 ownCloud, Inc. \n  - SPDX-License-Identifier: AGPL-3.0-or-later\n--\u003e\n# Nextcloud Contacts\n[![REUSE status](https://api.reuse.software/badge/github.com/nextcloud/contacts)](https://api.reuse.software/info/github.com/nextcloud/contacts)\n![Downloads](https://img.shields.io/github/downloads/nextcloud/contacts/total.svg?style=flat-square)\n[![Code coverage](https://img.shields.io/codecov/c/github/nextcloud/contacts.svg?style=flat-square)](https://codecov.io/gh/nextcloud/contacts/)\n[![Dependabot status](https://img.shields.io/badge/Dependabot-enabled-brightgreen.svg?longCache=true\u0026style=flat-square\u0026logo=dependabot)](https://dependabot.com)\n\n**A contacts app for [Nextcloud](https://nextcloud.com). Easily sync contacts from various devices with your Nextcloud and edit them online.**\n\nThis app only support vCard **3.0** and **4.0**. This app is compatible with the same browsers as server **except IE**!\n\n![](https://raw.githubusercontent.com/nextcloud/screenshots/master/apps/Contacts/contacts.png)\n\n## :blue_heart: :tada: Why is this so awesome?\n\n* :rocket: **Integration with other Nextcloud apps!** Currently Mail and Calendar – more to come.\n* :tada: **Never forget a birthday!** You can sync birthdays and other recurring events with your Nextcloud Calendar.\n* :busts_in_silhouette: **Sharing of address books!** You want to share your contacts with your friends or coworkers? No problem!\n* :see_no_evil: **We’re not reinventing the wheel!** Based on the great and open SabreDAV library.\n\n## Maintainers\n\n* [Hamza Mahjoubi](https://github.com/hamza221)\n* [Nextcloud Groupware team](https://github.com/nextcloud/groupware/#members)\n\n## :hammer_and_wrench: Installation\n\nThe app is distributed through the [app store](https://apps.nextcloud.com/apps/contacts) and you can install it [right from your Nextcloud installation](https://docs.nextcloud.com/server/stable/admin_manual/apps_management.html).\n\nRelease tarballs are hosted at https://github.com/nextcloud-releases/contacts/releases.\n\n## :satellite: Support\n\nIf you need assistance or want to ask a question about Contacts, you are welcome to [ask for support](https://help.nextcloud.com) 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](https://github.com/nextcloud/server) for help!\n\n### Could you add XXX property?\n\u003e 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.\nLong story short, we suggest you use the Notes field to add your custom data :)\n\nIf you'd like to join, just go through the [issue list](https://github.com/nextcloud/contacts/issues) and fix some. :)\n\n## Build the app\n\n``` bash\n# set up and build for production\ncomposer install\nnpm ci\nnpm run build\n\n# install dependencies\ncomposer install\nnpm ci\n\n# build for dev and watch changes\nnpm run watch\n\n# build for dev\nnpm run dev\n\n# build for production with minification\nnpm run build\n\n```\n## Running tests\nYou can run all front-end tests by using:\n\n```\n# run tests once\nnpm run test\n\n# run tests continuously after every change\nnpm run test:watch\n```\n\n## :v: Code of conduct\n\nThe Nextcloud community has core values that are shared between all members during conferences,\nhackweeks and on all interactions in online platforms including [Github](https://github.com/nextcloud) and [Forums](https://help.nextcloud.com).\nIf you contribute, participate or interact with this community, please respect [our shared values](https://nextcloud.com/code-of-conduct/). :relieved:\n\n## :heart: How to create a pull request\n\nThis guide will help you get started: \n- :dancer: :smile: [Opening a pull request](https://opensource.guide/how-to-contribute/#opening-a-pull-request) \n\nCommits in this repository follow the [Conventional Commits specification](https://www.conventionalcommits.org/en/v1.0.0/#summary).\n","funding_links":[],"categories":["Apps","JavaScript"],"sub_categories":["Official"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnextcloud%2Fcontacts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnextcloud%2Fcontacts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnextcloud%2Fcontacts/lists"}