Skip to content

Grateful ๐Ÿ™โœ๏ธ๐Ÿ“”is is a mobile application for Android users to practice daily gratitude by writing every day.

Notifications You must be signed in to change notification settings

aTamarsh/grateful

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

55 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Grateful

grateful

Grateful is a mobile application for Android users to practice daily gratitude by writing every day.

People who engage in daily gratitude tend to feel more positive emotions, relish good experiences, improve their health, deal with adversity better, and build stronger relationships. People will cultivate a greater sense of appreciation for the beauty in their lives by using Grateful and ultimately lead a more fulfilling and enriched life.

Installation & App Execution Instructions

  1. Flutter Installation Instructions

Follow the installation instructions linked above and begin by selecting the operating system you are currently on. Follow the linked guide to install the requisite dependencies for your respective OS.

The above-linked Flutter documentation is written well and easy to follow. You should have no issues installing the required dependencies (especially on Windows).

Note that you do not need to "Set up your Android device." Just set up the Android emulator via Android Studio. The most "complicated" portion might be enabling VM acceleration on your Windows machine. The documentation thoroughly covers these steps.

  1. Set up an editor

The next step is to set up an editor. The recommended one is VS Code because it comes with complete Fluter app execution and debug support.

  1. Download & Run Source Code

If you already have a copy of the source code on your system, you don't need to download the the v0.1.0-alpha release of Grateful from the above-linked GitHub repository. However, if you do not have the source code, please download the latest release of the source code from said repository.

Extract the grateful project's source code into your desired directory.

In VSCode, make sure you start an emulator from the bottom right of the screen by clicking on the available devices area:

VSCode's Device Selector in Bottom Right Portion of Screen

Then, select your desired Android emulator from the drop-down menu on VSCode. We suggest using the Pixel 6 Pro API 33 emulator because Grateful was built using this device emulator. See the screenshot below:

Select a device to use drop down button.

After you successfully load the Android emulator, navigate to the main.dart file (grateful/lib/main.dart) and click the "play" button on the top-right of your screen (or click on the button's drop down arrow and hit "Start debugging.")

main.dart file's play button.

Alternatively, you can simply right click on the main.dart file in the file navigation pane and click "Start debugging.":

main.dart file's right click options.

Alternatively, if you prefer using the terminal, cd into the grateful root directory and enter the command flutter run. This will launch the Grateful app on your select device emulator.

Grateful's StartScreen in an Android emulator.

Enjoy using the application!

Grateful on Android Screenshots

Grateful's Screens

Grateful's Screens

Grateful's Screens

About

Grateful ๐Ÿ™โœ๏ธ๐Ÿ“”is is a mobile application for Android users to practice daily gratitude by writing every day.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published