/chandler

The Monica mobile app (deprecated)

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

Monica Mobile Application

Personal Relationship Manager

Build Status Build Status

License License

Introduction

Chandler is Monica's official mobile app. Monica is an open source personal relationship manager available as a web application. While the web app has many features, the mobile application currently has a limited set of features. It lets you read your data from your web account. However, we are actively working on it and you will soon be able to:

  • add/edit a contact

  • add/edit activities

  • add/edit reminders

  • add/edit notes

  • add/edit calls

  • add/edit debts

  • add/edit tasks

  • Chandler is developed with React Native, a Facebook technology which allows you to build real native apps using only javascript. The philosophy behind this is learn once, write everywhere. Facebook's post about React Native explains it really well.

  • CircleCI is running unit tests and checking typings. Travis is running E2E tests.

Get started

With Monica official server

If you are you using Monica official server, it's very simple. You just have to install the app from the iOS App Store or the Android Play Store. Easy peasy !

With a standalone server

If you have installed Monica on a server accessible from outside (a local or global network), you will have to change the Monica Url server on the login page (set as https://app.monicahq.com by default).

⚠️ You will also have to fill in the new MOBILE_CLIENT_ID and MOBILE_CLIENT_SECRET environment variables in your instance. If it's your first installation, you likely have to generate those keys from your server by running php artisan passport:client --password. See the Monica docs for more information.

Running the app locally

You can see more information on the dedicated documentation page

Contribute

Do you want to help? That's awesome. Here are simple things you can do.

As a community

  • Unlike Fight Club, the best way to help is to actually talk about the project as much as you can (blog post, articles, Twitter, Facebook).
  • You can answer questions in the issue tracker to help other community members.
  • You can support financially the project on Patreon or by subscribing to an account.

Contribute as a developer

  • Read our Contribution Guide.
  • Install the developer version locally so you can start contributing instructions.
  • Look for issues labelled bugs if you are looking to have an immediate impact on the project.
  • Look for issues labelled Help wanted These are issues that you can solve relatively easily.
  • Look for issues labelled Good first issue These issues are for people who want to contribute, but try to work on a small feature first.
  • If you are an advanced developer, you can try to tackle issues labelled feature requests. Beware though - they are harder to do and will require a lot of back and forth with the repository administrator in order to make sure we are going to the right direction with the product.

We welcome contributions of all kinds from anyone.

Contact

If you need to talk, you can contact me at regis AT monicahq DOT com. You can also reach me on Twitter.

Thank you, open source

Monica use a lot of open source projects and we thank them with all our hearts. We hope that providing Monica as an free, open source project will help other people the same way those softwares have helped us.

License

Licensed under the AGPL License. View license.