nextcloud / nextcloud/server

Update & Improve Design of Nextcloud Mail Templates

Open
#48,095 4 comments 7 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

1. to develop design enhancement feature: emails
Dominant language
PHP
Stars
36.9k
Forks
5.2k
Avg merge
2d 3h
Merged PRs (30d)
713

Description

How to use GitHub
  • Please use the 👍 reaction to show that you are interested into the same feature.
  • Please don't comment if you have no relevant information to add. It's just extra noise for everyone subscribed to this issue.
  • Subscribe to receive notifications on status change and new comments.

Currently there has been nice design updates on Nextcloud as a whole, but it seems that the mail templates have been straggling a lot. There are some style aspects that could be improved, such as the spacing and font, and maybe there are other creative aspects that could be included which I'd leave to Nextcloud's awesome design team.

Technical aspects:

  • The code/approach for the mail template structure has grown quite outdated, hard to read and maintain. See here.
  • We should use a currently maintained mail-templating library to support as many mail-clients as possible. Just one example: https://documentation.mjml.io/

One example (Password-forgotten email):

  • I feel like the logo takes a bit too much space.
  • The font on the link is different than the one used otherwise in Nextcloud (although admittedly I'm uncertain if we can have Nextcloud Font supported accross multiple mail clients).
  • The Footer text is hard to read on white background.

Bildschirmfoto 2024-09-16 um 16 25 54

Anyway, maybe something that could be improved overall to make the NC mail templates feel nice and professional :) What do you think!

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with lib/private/Mail/EMailTemplate.php and inspect how the password-forgotten email is structured and styled. Review the suggested MJML approach and existing mail-client constraints; done means the mail templates have a consistent, professional design with improved spacing, typography, logo sizing, and footer readability across supported clients.

Written by the indexing model from the issue text.

Assessment

Tech stack
php
Domain
design
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.