WillACosta / astronomy

A project that uses NASA's API to show awesome pictures of the universe every day. Made with Flutter 💙

Language: English | Português

Astronomy is a mobile app made in Flutter to display awesome pictures and videos of the universe every day using NASA's public APOD API, containing features such as downloading, gallery usage, state management, saving favorites, animations and more.

Content

• Design
• Features
• Technical Resources
• How to Use
• Contributing
• App Flow Sample

Design

The app has a clean and minimalist proposal and also a style guide. You can copy this to your Figma account.

Features

• View the image of the day with an explanation written by a professional astronomer
• View a gallery of previous APOD images and jump quickly to any date
• Share and download any image in HD
• Dark mode
• Save your favorites
• Showcase features on first launch

Technical Resources

• Developed with Clean Architecture
• State management with MobX
• Unit testing
• Internationalization
• Animations and custom widgets
• Local storage with Hive
• Shimmer loading effect
• API Request using NASA'S APOD

How to Use

## clone this repo
$ git clone https://github.com/WillACosta/astronomy

## go to the directory
$ cd astronomy

## install the dependencies
$ flutter pub get

## rename the '.env-example' file to '.env' in the root directory with
$ mv .env-example .env

## open the file and add your API KEY (Get on https://api.nasa.gov/)

## run the app
$ flutter run

Contributing

If you've read this far, how about helping out and contributing to the project? Let's study together and make Flutter even better known! :)

App Flow Sample

---

Made with 🖤 by Will