now-u-app

Welcome! :wave:

This is the official repository for the now-u app. now-u is a non-profit started by James and Lizzie Elgar, aimed at driving positive change through coordinated monthly campaigns and actions. Volunteers from all over the world contributed to now-u, and are continuing to do so today, from app and web development, through designing and marketing. If you are reading this, there is a possibility you are a volunteer who has just been onboarded onto the team, and if this is the case, keep on reading! If not we appricate any contributions and are always looking for new members of the team so please don't hesitate to reach out.

If you want to learn more about now-u: Checkout our website https://now-u.com

Development :computer:

Whether you were formally onboarded onto the now-u team, or would like to contribute to some open source, now-u is extremely grateful for any input you may have, so firstly a massive THANK YOU! Although, if you are looking at contributing, please follow some code guidelines to ensure that this repository is kept clean for other contributors and volunteers.

  1. Pick an issue of your choosing from the issues tab on this Github repository. If there is no-one assigned to an issue, ask @JElgar to assign you, or assign yourself and let us know on slack.
  2. Once you get started set it as "in-progress" (you may have to assign it to the app project first)
  3. Make a branch (off dev) called either "feature/description" or "bugfix/description"
  4. Make the required changes
  5. Make a pr following the pr template

Setup :hammer:

Full setup guide - Getting Started

TLDR guide:

  1. Install flutter (and get a device setup)
  2. Clone the repo
  3. Run it - flutter run

Where to start? :information_desk_person:

To find out what needs doing checkout the issues. Select an issue that looks interesting to you and double check its not been assigned/in-progress. Issues have priorities but the real priority is what you find interesting.

Testing

To generate mockito mocks run

flutter pub run build_runner build

Documentation :book:

For more detailed documentation checkout the wiki!

Adding custom icons

Get the icon as an SVG. Open it in inkscape Ctrl-a to select everything and object > Ungroup, Path > Stroke to Path and Path > Union. Save that and add the icon to https://www.fluttericon.com/

Libraries

account_details_model
AccountDetailsPage
Action
action_info_model
ActionInfo
analytics
api_service
article
auth
base_model
button_styles&sizes
Campaign
campaign_info_model
campaign_page
campaign_view_model
card
Cause
cause_indicator
CauseOnboardingPage
causes_service
causes_view_model
causeTile
causeTileGrid
ChangeCausePage
ClipShadowPath
ConfirmationModal
constants
custom_network_image
customAppBar
customIconButton
customIcons
Flutter icons MyFlutterApp Copyright (C) 2020 by original authors @ fluttericon.com, fontello.com This font was generated by FlutterIcon.com, which is derived from Fontello.
customRoute
customScrollableSheet
customTile
customWidthButton
darkButton
device_info_service
dialog_manager
dialog_service
dialog_type
emailSentPage
Explorable
explore_page_view_model
explore_tiles
ExplorePage
ExploreSection
FAQ
faq_model
faq_service
FAQPage
firebase_options
google_location_search_service
Home
home_model
InfoPage
inputs
internal_notification_service
intro_view_model
IntroPage
Learning
locator
logger
login
login_code_view
login_model
main
MoreMenu
news_service
Notification
notification_model
NotificationPage
notifications
Organisation
organisation_service
OrganisationPage
organisationTile
partners_model
PartnersPage
profile_setup
profile_setup_view_model
ProfileTile
progressTile
pushNotifications
remote_config_service
routes
SDG
search_service
search_view_model
SearchPage
sectionTitle
shared_preferences_service
SplashScreen
startup_model
startup_view
storage
StyleFrom
superbase
Tabs
tabs_view_model
textButton
User
user_service
utils