Skip to content

joshrap67/StarSandwich

Repository files navigation

Star Sandwich

Mobile app for determining what star is directy above and below you at a given time and location on Earth. The application interacts with a Node.js web service hosted on AWS.

The user can either use their GPS to determine their location, or can manually enter an address (currently only supported for users in U.S. or Canada).

Demo of Star Sandwich version 1.1.0

Refer to the Wiki for details on the application logic.

Prerequisites

This application is currently only published for Android devices. The minimum SDK version that this application can run on is: 24. The targeted SDK for this application is: 36.

An internet connection is required to run this application.

GPS location is required if not using the manual mode.

If pulling from this repository, Flutter is required in order to run the application.

Deployment

If pulling from this repository, open the project and run it using Flutter (can be done via CLI). If doing it this way, you may need to ensure that you have developer options enabled on your device.

To run a production build:

flutter run --release

To deploy the web service, run the lambda package batch script and upload that zip file to AWS Lambda.

Built With

  • Flutter - Framework that the frontend was built with.

  • Node.js - Framework that the backend was built with.

  • Android Studio - IDE that was used to build the frontend.

  • WebStorm - IDE that was used to build the backend.

  • Inkscape - Vector graphics software used to create the logo and constellations.

Authors

  • Joshua Rapoport - Creator and Lead Software Developer

Acknowledgments

Source of background image for app and feature graphic

Selected data found from AstroNexus repository

Source for formula used to obtain Greenwich mean sidereal time

API used to determine lat/long for a given address in the U.S. and Canada

About

Mobile app for determining the nearest star that is directly above and below you at a given time and location on Earth.

Topics

Resources

License

Stars

Watchers

Forks

Contributors