ncosgray / cuppa_mobile

A simple tea timer app for Android and iOS built with Flutter.

☕ Cuppa

Cuppa is a small application to time your cup of tea as it steeps. Tired of leaving your tea too long, to become bitter and cold, or drinking it too soon and not appreciating its full potential? Then this utility is for you!

Tea Timer App for iOS and Android

To make the app so quick and easy that you'll actually use it, we have built it with simplicity in mind. Just open the app and tap the button for the type of tea you're brewing. That's it. No need to navigate through complicated menus to find a particular tea, or fiddle with settings... unless you want to customize brew times or add your own favorite teas.

Once you tap, Cuppa will begin timing the brew and you'll see a teabag appear in the cup and gradually darken as the tea steeps. A countdown timer shows the steep time remaining. You can have up to two separate teas brewing at once, each with its own countdown timer. When the tea is done Cuppa will let you know with a notification -- depending on your device settings, this may be accompanied by a sound and/or vibration.

Install

Android (4.4+)	iOS (12+)

Join the Team

• Pull requests for new features or bugfixes are welcome.
• Chat in our GitHub Discussions forum.
• Use Weblate to contribute a translation for your language.

Translation status

Mobile app:

Android app store description:

Support the Project

Buy us a cup of tea to support active development of Cuppa.

Ethereum: 0xc5be97ea75ad15854ed09529139e672fae2f63c0

About

Cuppa Mobile is a free, open-source mobile app licensed under the terms of the BSD license and built on the Flutter framework.

Author: Nathan Cosgray

cuppa_mobile's Issues

App doesn't start timer but just closes itself on iOS

I've tried the App on iPhone SE (iOS 12.1) but can't get it to work.
When I press one of the icons to start the timer the app just closes itself. No timer is started and also no notification appears.

More animations

Add an option where we can change animation types.

Ideas:

• Hourglass, where speed of animation is set by time from start to finish
  Video example: link

Also, found some great animations that could be used: link, like if you're a chemist, you may like a beaker, if you're a mechanic, you may like a gear etc... Hourglass on page 12

Different sound notifications

Currently there is no setting to choose a notification sound when the timer is done.

Add the setting to choose between different sounds when the time runs out.

Option to force language change

Users may sometimes prefer other language in the app, like English, although they have it translated.

Please add option to change a language in the app from a default one to a selected one.

Temperature info

Tea steeping water temperature is important.
Please add Temperature presets to the existing teas.

probably:

• Black Tea: 100°C
• Green Tea: 80°C
• Herbal Tea: 100°C

License?

Please consider adding an open-source license for this project.

https://choosealicense.com

There are teas that brew less than one minute

Hello! I just wanted to use your app to brew my green tea, but realized you can not configure teas brewing 45 seconds. What a shame! For loose leaf tea such short times are very common.

Tea Button Statuses

Please add the ability to hide or show tea type buttons (main screen) so that the user can hide teas they never make (set in settings).

Landing page/website improvement

In my opinion, Github Readme currently looks better than your website for the app sharing.

I hope you can improve your website in a way, that the entire page (for example) or a selected tab is being used, whereas currently a lot of the left side of the screen is used for other info not related to the app. It looks sort of like a blog.

Examples of app landing pages: https://designshack.net/articles/inspiration/best-app-landing-page-templates/

Favourite teas feature

Add an option to favourite teas, so these would display at the top of the list.

This would be useful when users will add many teas to their tea list and would like their favourite ones at the top.

As @mondlicht-und-sterne mentioned in issue #20 :

When more (or many) teas have been added to Cuppa, it could also be possible to display teas as favourites, i.e. you could then select and deselect the favourites yourself.

Feature request: AMOLED Black theme

The problem: The app has dark and light themes, but no pure black theme. Pure back theme would have more contrast and would consume less battery on AMOLED screens

Proposed solution: Add theme with the pure black background, maybe adjust colors of buttons and frames to correspond the theme.
I made a quick example of how it could look like:

Screenshot

Dark Mode

Please consider adding a dark mode.

Feature request: Open directly from lockscreen

I have Cuppa as a shortcut on my android lockscreen.
Currently you have to unlock the device when the shortcut is pressed. It would be great to not have to do so, making it much easier to start the timer.
This appears to be a flag set on the activity. (FLAG_SHOW_WHEN_LOCKED)

Button Labels Fixup

Steps to reproduce:

1. Open to main screen (first page)

Expected behaviour: What did you expect to happen when performing these steps?

Button labels fit on buttons.

Observed behaviour: What actually happened and why is it a problem? If applicable, consider adding screenshots to help explain.

Some button labels don't fit horizontally.

Device information: Include your device operating system and version.
Android 7.0 mobile phone.

Screenshots:

Exit editor

If you click on an empty spot when editing tea's name, the editor doesn't exit, but always stays in that spot. Examples are red spots. Clicking on that area doesn't exit the editor. You can only minimize a keyboard, but the window for editing is still active.

When clicking on an empty area, please exit the editing for a current element.

This feature works for exiting the temperature editor or color picker, but not for the text editor.

New feature: Countdown notification

When the app is minimized, there is no notification indicator while the app is counting down so you can see how much time is left.

Please add a notification countdown timer, when the app is minimized. Similar to the stock android countdown timer when it is counting.

Example with the Android system countdown timer:

EDIT: added photo and fixed text.

Feature request: dark mode (gray) to be separate from black mode

The problem: in a new update, gray background was replaced by a completely black background, which looks weird.

Proposed solution: Make black theme an optional setting and make dark theme default

Bug report: Quick actions sometimes trigger unexpectedly on Android

Steps to reproduce:

1. Use a quick action by long-pressing on the app icon to start a new tea timer.
2. Tap the notification when brewing is complete.
3. Navigate away from Cuppa and then wait about two hours.
4. Open the app by tapping the app icon.

Expected behavior: Cuppa starts with no active timer.

Observed behavior: Cuppa starts and immediately initiates a new tea timer, as if a quick action was selected.

Translation platform

if this app is going to be actively developed, it would be great if there was a way for general public to contribute translations.

I can recommend Weblate, as the platform itself is popular, open source (compared to others), can be self hostable, and for open source projects like yours, they host translations for free. Weblate automatically makes pull requests afaik and if you want you can have a widget shown on github, that displays how much percentage each applied language has translated. It's much more simple for people to translate this way and it's free.

• set up your libre project

screenshot:

Measurement system toggle ?

When installing an app, temperatures are automatically displayed in an Imperial measurement system, which is a problem if you use metric system like most of the countries and don't know to convert the temperatures.

Could there be a settings toggle, Measurements: Metric/Imperial ?

This way it would convert temperatures, change measurement from Fahrenheit to Celsius or vice-versa, and we could also avoid displaying of 2 measurement systems in the temperature selection.

Maybe it could select that feature automatically based on a local system settings (if that's possible), or maybe there could be an introduction screen when first-ever running the app with the option to set this.

Last Teas

a menu item, show the last tea(s) I drank

New feature: App version information inside the app

There is no way to check which version of the Cuppa is installed, by checking inside the app, which is usually basic information.

Please add information inside your app, to know which version it is.

Change tea colour in image over time

Nice to have feature: change the colour of the tea in the image with the cup while the countdown is running.

This might be possible by using the flutter svg plugin andupdating the colour within the svg over time.

Community discussion group

• I made a discussion group on telegram, where users can discuss the app in real time: https://t.me/CuppaMobile
• Telegram is usually used for groups like this.
• If you dislike this decision, i can delete the group.
• if you @ncosgray join it, i will make you an Owner/admin of it.

Custom tea timers

Allow the option to create custom tea timers with custom names, times, temperatures etc.

Also add the option to delete the timers.

Re-order teas by drag-drop list

It would be nice if users could reorder their tea list like so, that they find most useful, for example the tea that they make the most could be more up the top, than the tea that is rarely made.

Make a simple "edit" button that opens reorder menu, to put some teas more up and some down, depending on user's preference.

Release on F-Droid

It would be really nice if you could release the app on F-Droid, where most of the open source android apps are.
It could get community more involved as your app would be findable there.

No sound upon notification

Steps to reproduce:

1. Set a timer
2. Wait
3. Notification will produce no sound, except a vibration.

Expected behavior:

When a timer is finished, there should be a sound notification, so we can know audibly that the tea is ready.

Observed behavior:

When a timer is finished, there is no sound in a notification, even when the phone's volume settings are all set on highest setting. The phone only vibrates.

This issue has been going on for a while and it prevents me from using the app efficiently.

Device information:

Asus Zenfone 6, stock Android 11

Specify number of infusion

First of all: thanks for this app!

I was amazed to discover it in the F-Droid app store 😻

One thing I'm missing right now is the ability to tweak the timer depending on the number of infusion I'm making right now.

Is it possible to add this without having to reconfigure the tea timer every time?

Minutes selection - empty spaces

The time that can be selected, has empty spaces if the minutes are one digit number, like in screenshot:

Please remove the spaces, if the minutes are one-digit.

Bug report: Android notification has no timestamp

Steps to reproduce: Start a timer and wait for a Brewing Complete notification.

Expected behavior: Brewing Complete notification should include a timestamp telling the user when the timer finished, e.g. "now" or "5 min ago".

Observed behavior: The notification does not show a timestamp at all.

Device information: Android.

Donation platforms

Is your feature request related to a problem? Please describe.
Currently there's no donating information, if users want to show appreciation like that.

Describe the solution you'd like
Add a Donations section to the readme and some buttons below as to where donate.

Describe alternatives you've considered
If you comment the information of the donation methods you use and addresses, i will do it for you and make a pull request, did this a couple of times.

I saw a lot of open-source projects use LiberaPay or other in the list:

• LiberaPay -- example
• PayPal
• Github Sponsors
• Ko-fi
• OpenCollective -- example
• Flattr
• BountySource

Displaying a sponsor button in your repository: link
Some donate buttons

Feature request: Custom (hours longer) timers for Cold Brewing tea

Current issue:

• Teas can also be cold brewed and it's very good if done so. "You can cold steep your teas for as little as 2 hours or even as long as 12 hours and more."
• Cuppa currently supports max 19 minutes and 45 seconds

Suggested feature:

• Please add an option to set custom timers, so you can brew 6, 12, 24 hours (or any preffered amount) etc...
• At the end of the minutes or seconds, there could be a "Set custom time" option, where you can then enter it manually, including hours.
• Add a toggle "include cold brewing", which would enable setting hours and custom cold temperatures.

Source: Theteacupoflife

Feature request: Custom tea colors

Currently the teas have some preset colors.

(Maybe) it would also be nice if below the presets there would be a color picker, that would enable you to select from a more colorful color palette.

Teas list to be scrolling when moving items

When moving a tea up or down, the list doesn't change perspective/move up or down, but stays fixated, so you can't move the tea down the list at first try.

Please make the list move/scroll automatically if you try to move teas down or up at the edge of the list if there are more items above/below.

Example, the list doesn't move when moving from the bottom, although there are some teas above the top option.

Improve share thumbnail

(if it's even possible) add a Cuppa icon to the thumbnail when sharing the github link.

Currently (Signal messenger) :

Feature request: Change images from .png to vector

As the title says, changing to vector images will look better.

More Teas

Greetings!

Thank you for this great simple app.

Are there plans to add support for optionally letting the user add further custom teas?

The settings page could be scrollable and the front page could have e. g. horizontally scrollable tea timer buttons.

I think, this wouldn't increase the complexity of the app, especially when it's optional, anyway.

Feature request: Option to remove all teas

Maybe some people only use the app for one or two teas, or maybe some just want to delete all teas to set them again from the start.

Add an option to remove all teas from the list.

If all teas are removed, there should be a message on the main screen, where the tea buttons normally are, message saying "add teas in settings" or something like that.

Categories

1. create categories
2. being able to classify teas into categories
   This has the advantage that you do not have to enter the categories each time.

Examples::

Black Teas

Black Tea
Assam
Ceylon
Earl Grey

White Teas

White Tea
Pai Mu Tan
Xin Zhen

About page

Add "About" page in the settings, where you add:

• App logo
• App description
• Link to source code

or more...

Feature request: Shortcut to system sound notifications for Cuppa

The problem: Currently, users have to navigate to system settings to change the notification sound for Cuppa, which only tech-savvy people can do.

Proposed solution: Include a shortcut button in the Cuppa app, that leads to the system sound notification setting for Cuppa app.

Feature request: Introduction wizard / tutorial

The problem: Currently when a Cuppa app is installed, a user is expected to know the functions of the app, since there is no helper information.

Proposed solution: Implement an onboarding wizard or an introductionary helper / tutorial, that would tell the user of the main functions, where to find them or guide the user towards that functions by showing arrows. This issue can have more similar functions added to it.

Bug report: Follow system says it's a black theme

Expected behavior: What did you expect to happen when performing these steps?
In the theming options, the follow system is said to be black, while it should say Dark, as i have a dark system theme.

Observed behavior: What actually happened and why is it a problem? If applicable, consider adding screenshots to help explain.
It's not accurate, as Black or Dark system themes are different

Device information: Include your device operating system and version.
Asus Zenfone 6, Android 11

Temperatures in Celcius

Hello,

Thank you for Cuppa, very useful!
Could you implement an option to use temperatures in Celcius? In regions using the metric system, Fahrenheit degrees are just meaningless. 🙂

Feature request: remove notification upon entering the app

The problem: Currently, when the app is minimized and the timer finishes, the notification shows up, but when you open the app, the notification doesn't disappear.

Proposed solution: If possible, remove the notification, after you enter the app.

Bug report: In Vibrate mode only silent notification when screen is off or app in background

Steps to reproduce:

1. Set notification settings for Cuppa
   
2. Put device in non-silent mode (ringtone volume > 0)
3. Start the timer
4. Lock screen (short press of power button)
5. Wait until countdown over => Audible notification
6. Put device in vibrate only mode
7. Start the timer
8. Keep screen on, wait until countdown over => Device vibrates
9. Start timer again
10. Press home button to put app to background
11. Wait until countdown over => Silent banner notification appears, no vibration
12. Start timer again
13. Lock screen (short press of power button)
14. Wait until countdown over => Device lights up and shows lockscreen notification, no vibration

Expected behavior: Actually I'd expect an audible notification always (unless sound is set to mute in Notification settings), like for an alarm app. But at least I'd expect the device to vibrate when tea is ready.

I tested notifications with Tasker with identical notification settings. This works, no matter of the notification priority. So I'm not sure what is the issue here.

However, I guess I'd, anyway, recommend to use the "alarm" audio stream to play an alarm instead of relying on normal notifications (which use the "ringtone" stream I guess).

Observed behavior: Only a silent lock screen notification or notification banner is shown.

Device information: Huawei P20 Pro, Android 10

Bug report: Two timers in row - second timer no notification

I have 3 custom timers. Sometimes I start one timer and get a notification after time is up. I instently start another timer, but then I never get a notification after time is up. The notification starts whenever I open the app next time.

Weblate translating issue

Some content isn't translatable currently, as it says it's in maintenance mode.

Screenshots in Readme.md

There is currently no screenshots in readme on github page.

Please add screenshots.