Welcome to the NASA APOD Wallpaper Carousel! This React TypeScript application displays NASA's Astronomy Picture of the Day (APOD) in a beautiful carousel format. You can deploy it using AWS CloudFront for a seamless experience.
- Daily Updates: Get the latest astronomy picture every day.
- Responsive Design: Works well on both desktop and mobile devices.
- AWS Deployment: Utilizes AWS CloudFront for fast content delivery.
- Customizable Carousel: Users can navigate through images easily.
- Open Source: Contribute to the project and help improve it.
- React: A JavaScript library for building user interfaces.
- TypeScript: A superset of JavaScript that adds static types.
- Vite: A fast build tool for modern web applications.
- AWS S3: For storing static assets.
- AWS CloudFront: For content delivery.
- CSS: For styling the application.
To set up the project locally, follow these steps:
-
Clone the repository:
git clone https://github.com/LuizFlaviodoCarmoRocha/wallpaper.git
-
Navigate into the project directory:
cd wallpaper -
Install the dependencies:
npm install
-
Start the development server:
npm run dev
Visit http://localhost:3000 in your browser to see the application in action.
The application displays NASA's Astronomy Picture of the Day. Users can navigate through images using the carousel controls. Each image comes with a title and a brief description.
- Next: Move to the next image.
- Previous: Move to the previous image.
- Pause/Play: Stop or start the automatic slideshow.
You can customize the carousel's appearance and behavior by modifying the relevant components in the src directory.
To deploy the application, you can use AWS CloudFront. Here are the steps:
-
Build the application:
npm run build
-
Upload the contents of the
distfolder to an S3 bucket. -
Set up CloudFront to serve the S3 bucket.
-
Access your deployed application via the CloudFront URL.
For a detailed guide on deploying with AWS, refer to the AWS documentation.
We welcome contributions! If you want to help improve this project, please follow these steps:
-
Fork the repository.
-
Create a new branch:
git checkout -b feature/YourFeatureName
-
Make your changes and commit them:
git commit -m "Add your message here" -
Push to your fork:
git push origin feature/YourFeatureName
-
Create a pull request.
Please ensure that your code follows the project's style guidelines.
This project is licensed under the MIT License. See the LICENSE file for details.
For the latest releases, visit the Releases section. You can download the latest version and execute it to explore the features.
For any issues or feature requests, check the Issues section.
Thank you for checking out the NASA APOD Wallpaper Carousel! We hope you enjoy exploring the wonders of astronomy through this application. If you have any questions or feedback, feel free to reach out.