JW Time

JW Time is the easy way for Jehovah's Witnesses to manage their field service priorities.

View it live

Preview

Help Translate 🌐

JW Time is automatically translated into 12 languages by means of Google Cloud Translate. These translations might not always be the highest quality. To help, proofread these translations on Crowdin. Thank you!

Not sure how to use Crowdin?

Current translations:

1. German - Machine Translated
2. Spanish - Manually Reviewed
3. French - Machine Translated
4. Italian - Manually Reviewed
5. Japanese - Machine Translated
6. Korean - Manually Reviewed
7. Dutch - Machine Translated
8. Portuguese - Machine Translated
9. Russian - Machine Translated
10. Vietnamese - Machine Translated
11. Chinese - Partially Manually Reviewed
12. Tagalog - Machine Translated

Help Code ⌨️

Any assistance is welcome! Look at the following and see if anything looks interesting to you:

1. Open issues
2. Project board

If you find something you'd like to help with, please let me know you've began work on it so it doesn't become double-worked. Thank you!

Environment

To start the Expo Dev server, begin with yarn install & yarn run dev.

Note: Local environment variables set in ./package.json scripts rely on a unix based environment variable assignments. If your system is Windows, try using WSL to start development of this project.

You must use a development build, not Expo Go.

In order to get a development build, you can compile the application with EAS eas build -p [ios/android] --profile development --local.

After that, open the compiled development build in your simulator/device and connect to the local Expo Dev Server.

🎉 You did it! (Hopefully)

Project Structure

• .github Configuration files for Github actions.
• .husky Configuration files for husky, a git hooks library.
• .tamagui Configuration files for tamagui, a component library used in only portions of the project.
• .vscode VSCode configuration files for extensions.
• App.tsx Application entry point.

• src This is where all of the project source code lives.

  • __tests__ Where all of the tests for the project lives.
  • assets Where local assets such a images, icons, and lottie animations are stored.
  • components All of the components of the project.
  • constants Variables that are constant throughout the app and do not change.
  • contexts Stores the internal React Contexts.
  • docs The documentation and related assets for this repository.
  • hooks Contains the custom React Hooks for this project.
  • lib Contains many functions that are useful for app functionality. Generally, shared functions should come from a lib instead of directly from a component.
  • locales The translations files for each locale - en is the master.
  • providers The React Providers for the contexts.
  • screens Contains all screens that the app can display.
  • scripts Local CLI scripts for various CI/CD functions.
  • stacks All native stacks of used for React Native Navigation.
  • stores The AsyncStorage APIs for CRUD operations of app data using the device's storage.
  • types Shared type definitions.

.env Keys

• GOOGLE_CLOUD_API_KEY Used for cloud translation API calls in CLI
• HERE_API_KEY Used for geocoding api calls when users create address to fetch coordinates
• GOOGLE_MAPS_ANDROID_SDK_API_KEY [Android] Maps SDK Api allows use of Google Maps within application
• REVENUECAT_APPLE_API_KEY [iOS] Allows use of revenuecat service for in-app purchases for donations
• SENTRY_AUTH_TOKEN Token that enables Sentry application error logging
• EXPO_PUBLIC_SENTRY_PROJECT Configuration for sentry's project
• EXPO_PUBLIC_SENTRY_ORG Configuration for sentry's organization
• APP_VARIANT Set to development when working locally, targets the eas build to create the JW Time Dev bundle instead of production JW Time

Help Financially 💖

Donations are never expected but greatly appreciated! These donations are used to offset the costs of:

• App Store Fees ($100/yr)
• Here API Calls (Currently $0/mo)
• Google Cloud Translation (<$5/mo)

These expenses are kept up to date here. Thank you!

You may wish to donate in the app by pressing on the heart icon or more directly at Ko-Fi, without Apple's 30% cut, below:

License

JW Time © 2024 by Levi Wilkerson is licensed under Attribution-NonCommercial 4.0 International