On This Day

Description

"On This Day" is a Chrome extension that retrieves and displays historical events that took place on the current date. Each day, it fetches and displays a curated list of historical events that occurred on the current date.

This is a living and expermintal project, constantly evolving with new features and improvements. Contributions, suggestions, and feedback from the community are always welcome.

Features

• Historical Events: View random historical events that happened on this day in history.
• Favorites: Like events and save them to your favorites for later reference.
• Offline Access: Download events for personal record or offline access.
• Social Sharing: Share events on social media.
• Easy Refresh: Easily retrieve new events with a click, refreshing your daily historical insights.

Technologies

• TypeScript
• React
• TailwindCSS
• Node.js & Express
• Unsplash JS API
• Wikipedia API
• MongoDB

Setup and Installation

Clone Repository

Setup for Backend

  cd server
  yarn install

Setup for Frontend

  cd client
  yarn install

Environment Variables and Prerequisites

• Ensure Node.js (v20.1.0 or later) is installed. -PORT: the backend server runs on 8000 -MONGODB_USERNAME: MongoDB username for connection string
• MONGODB_PASS`: MongoDB password for connection string

Running the Application

Backend

cd server
yarn server

Frontend

cd client
yarn client

Usage and Contribution

This extension is currently not published. To use it as a Chrome extension, upload the client build into Chrome's 'Unload Pack' after setting up the environment variables. This project can serve as a template to customize your cards or contribute to styling and refining the query algorithm.

License

This project is licensed under the MIT License.