Skip to content

Astro Dodge is a web app that tracks Near Earth Objects using NASA's Open APIs.

License

Notifications You must be signed in to change notification settings

kev-odin/astro-dodge

Repository files navigation

Astro Dodge

Astro Dodge is a web application that tracks Near Earth Objects (NEOs) using NASA's Open APIs. It allows users to create an account, track specific objects on a watchlist, and and learn more details about a specific object.

Description

astro-dodge astro-dodge astro-dodge astro-dodge astro-dodge astro-dodge astro-dodge

Table of Contents (Optional)

Installation

Docker Compose

  1. Copy this repository and run the command: docker compose up
  2. This will build the images necessary to run this project.

Docker

A ready to use Docker image should be hosted in the GitHub Packages Container Registry.

  1. Simply pull the image from this repository with: docker pull ghcr.io/kev-odin/astro-dodge:latest
  2. Run the image with this command: docker run astro-dodge:latest
  3. Then open your web browser and enter localhost:5000 in the address bar.

Local Install

If you don't have Docker installed, you can follow these steps to install and run the Astro Dodge web application:

  1. Clone the repository: git clone https://github.com/kev-odin/astro-dodge.git
  2. Install dependencies using Poetry: poetry install
  3. Start the development server: poetry run flask run

This will start the Astro Dodge web application and it will be accessible at http://localhost:5000/.

Features

astro-home

Mobile-Friendly Design

Astro Dodge is designed to be mobile-friendly, with responsive design that ensures the application looks great and functions well on any device.

CI/CD with GitHub Actions

Astro Dodge uses GitHub Actions for Continuous Integration and Continuous Deployment. When code is pushed to the main branch, GitHub Actions automatically runs the tests and builds a Docker image that is stored in the GitHub Container Registry.

Tech Stack

Python Docker Flask postgresql Pytest insomnia Bulma DigitalOcean github actions

How to Contribute

If you are intrested in contributing to this project, feel free to create an issue, fork the repository, and create a pull request. If new features are added, write relevant unit and integration tests to ensure code coverage.

Tests

To run tests, you will need poetry installed. Learn more about the installation process here.
Run this command: poetry run pytest

License

Astro Dodge is licensed under the MIT License.

About

Astro Dodge is a web app that tracks Near Earth Objects using NASA's Open APIs.

Topics

Resources

License

Stars

Watchers

Forks

Packages