Solar Watch Application

This project provides sunrise and sunset times for any city on any given date. Just input a location and a date, and get accurate daylight information.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation

About The Project

Solar Watch is a full-stack web application that allows users to check sunrise and sunset times for any city on any date. The application features a clean interface and provides accurate astronomical data through integration with external weather and geocoding APIs. Built with modern technologies, it showcases best practices in software development, including containerization with Docker, RESTful API design, and responsive frontend development.

(back to top)

Built With

Frontend

• 
• 
• 

Backend

• 
• 
• 
• 
• 

DevOps

• 
• 

(back to top)

Getting Started

To get a local copy up and running, follow these simple steps.

Prerequisites

Before you begin, ensure you have the following installed on your system:

• Docker (v20.10.0 or higher)
• Docker Compose (v2.0.0 or higher)
• Node.js (v18.0.0 or higher)
• Java Development Kit (JDK) (v21 or higher)
• Git

Installation

1. Clone the repository

   git clone https://github.com/CodecoolGlobal/solar-watch-MVP-java-toro-m.git
   cd solar-watch-MVP-java-toro-m

2. Set up environment variables

   • Copy the .env.template file and rename it to .env
   • Update the values in .env with your configuration:

     DB_USERNAME=postgres
     DB_PASSWORD=your_secure_password
     DB_URL=jdbc:postgresql://postgres:5432/solar_watch
     SECRET_KEY_JWT=your_secure_jwt_secret
     JWT_EXPIRATION_MS=86400000  # 24 hours in milliseconds
     

3. Start the application

   • Using Docker Compose (recommended):

     docker-compose up --build

   • The application will be available at:
     • Frontend: http://localhost:5173
     • Backend API: http://localhost:8080
     • PostgreSQL: localhost:5432

(back to top)