monicahq/marketing_site

The new Laravel based marketing site for Monica

Welcome to the marketing site of Monica.

It also contains

• the documentation of the API
• the release notes generator.

Deployment

• The site is hosted on Fortrabbit. DNS is on Cloudflare and Hover.
• To push new code in production, we have an action called Deploy.yml that pushes new commits to the main branch automatically.
• To update the sitemap: php artisan sitemap:generate. Then commit it and push to production.

Contact

If you need to talk, you can contact us at support AT monicahq DOT com.

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

Copyright (c) 2016-2023 Monica

Licensed under the AGPL License. View license.

marketing_site's Issues

Add a 'Log in' button to monicahq.com

The problem
I'm always frustrated when I go to monicahq.com and there is no 'log in' button. I have to click 'Sign up' and then the 'log in' link appears, which isn't very intuitive.

Describe the solution you'd like
An obvious button on the home page that takes me straight to log in.

Describe alternatives you've considered (optional)
Change the top right button text from 'Sign Up' to 'Log In / Sign up'

Additional context
See screenshot of current home page (note lack of 'Log In' button)

API documentation for countries

The documentation at https://www.monicahq.com/api/countries claims that counties are in an array

{
  "data": [
    {
      "id": 63,
      "object": "country",
      "name": "Afghanistan",
      "iso": "af"
      ...

However, that not the on my Monica instance, it returns them in a object:

{"data":{"AFG":{"id":"AF","object":"country","name":"Afghanistan","iso":"AF"},"WSB":{"id":"WSB","object":"country","name":"Akrotiri","iso":"WSB"},...

By the way, a link to "Country's API" from https://www.monicahq.com/api/addresses goes to https://www.monicahq.com/api/countries.md, which is dead. Correct url is probably https://www.monicahq.com/api/countries

Documentation missing for /api/contacts/:id/avatar

I found monicahq/monica#3302 and then the avatar test files, and so I managed to figure out that the API looks like:

PUT /api/contacts/:id/avatar
{
source: "photo",
photo_id: 1
}

Maybe there are also other changes from monicahq/monica#3302 which need added to the docs? I'd be open to looking into submitting a PR. Just let me know if that would be appreciated.

Better way to display new features in the changelog

https://www.groovehq.com/better

Link to self-hosting guide is broken on https://www.monicahq.com/

Steps to reproduce:

1. Browse to monicahq.com
2. Try clicking the link embedded in the call-to-action text "No credit card required. Or install it on your own server."
3. End up with a 404 link on Github

Expected behavior:
Link should point to https://github.com/monicahq/monica/blob/4.x/docs/installation/readme.md instead.

Malformed Rendering in Addresses API Documentation

The following particular line is not rendered properly:
https://github.com/monicahq/marketing_site/blame/0d98f15ba920a8ca358d10f58808a876403371f6/api_documentation/addresses.md#L223

You can see it here:

marketing_site/api_documentation/addresses.md

Line 223 in 0d98f15

| country_id | integer | The country ID of the country the contact lives in. Country IDs are retrieved through the <a href="{{ "/api/countries" | prepend: site.baseurl | prepend: site.url }}">Country's API</a>. |

Quick link to the docs

I just ran into the docs by searching the web.
I recommend putting a link to it on monicahq.com at the header or footer.

Suggestion: show mobile screenshots

Hi there,

I recently heard about Monica and wanted to check it out. I imagine most of the time I use it would be on my phone, after a chat with a friend or contact. I'm curious what the mobile experience is like, so some screenshots of that at https://www.monicahq.com/features would be helpful to sell people like me on the product.

Regardless, love what you guys are doing!

Thanks,
Alex

Broken RSS link

On https://www.monicahq.com/ an RSS feed is advertised which points to a 404 page. The Atom feed works just fine.

Thanks!

The roadmap link on monicahq.com is not publicly accessible

It's minor, but there's a link to the roadmap on monicahq.com's footer. It links to https://github.com/monicahq/monica/projects/1 which returns a 404 to the public- I'm guessing it's accessible by project members.

(I wanted to learn more and look at the roadmap for future features, and came across this. )

Thanks!

Monica API Doc has Invalid JSON example for Contact Creation

https://www.monicahq.com/api/contacts#create-a-contact

Current published example:

{
  "first_name": "henri",
  "last_name": "troyat",
  "nickname": "Rambo",
  "gender_id": 1,
  "birthdate_day": null,
  "birthdate_month": null,
  "birthdate_year": null,
  "is_birthdate_known": false,
  "birthdate_is_age_based": true,
  "is_birthdate_known": false,
  "birthdate_age": 29,
  "is_partial": false,
  "is_deceased": true,
  "deceased_date_day": 2,
  "deceased_date_month": 2,
  "deceased_date_year": 2017,
  "deceased_date_is_age_based": false,
  "is_deceased_date_known": true,
}

Problems:

• Last entry is_deceased_date_known has a trailing comma that needs to be removed.
• The entry is_birthdate_known is listed twice, one needs to be removed.

Suggested example:

{
	"first_name": "henri",
	"last_name": "troyat",
	"nickname": "Rambo",
	"gender_id": 1,
	"birthdate_day": null,
	"birthdate_month": null,
	"birthdate_year": null,
	"is_birthdate_known": false,
	"birthdate_is_age_based": true,
	"birthdate_age": 29,
	"is_partial": false,
	"is_deceased": true,
	"deceased_date_day": 2,
	"deceased_date_month": 2,
	"deceased_date_year": 2017,
	"deceased_date_is_age_based": false
}

Gramatical error

Under the section about disclosing to law enforcement it reads

In certain situations, we may be required to disclose personal data in response to lawful requests by public authorities, including to met national security or law enforcements requirements. We just hope that this never happens.

Line 2 should replace met with meet... Unless is some form of silent way of saying that you've had to comply, then let me know and I can make this issue go away.

Speak soon