Skip to content

danikova/event-horizon

Repository files navigation

Event Horizon

License: MIT GitHub stars

Event Horizon is a simple and customizable countdown timer web application. It allows users to create and share countdowns with personalized titles, background images, and theming options. The app is fully client-side and doesn't require any backend services.

Table of Contents

Project Overview

Event Horizon is designed to be a lightweight, easy-to-use countdown timer that can be customized through URL parameters. The application is fully responsive and supports theming based on user preferences. Users can set a custom background image and configure the timer's display without any server-side requirements.

Features

  • Customizable Countdown: Set a countdown to any specific date and time.
  • URL-Based Configuration: Modify the countdown settings via URL parameters.
  • Dynamic Background Image: Use an Imgur link to set a custom background image.
  • Responsive Design: The layout adapts to various screen sizes and devices.
  • Theming Support: Switch between light and dark themes, or let it match the system settings.

Technologies Used

  • React: JavaScript library for building user interfaces.
  • JavaScript/HTML/CSS: Core web technologies.
  • Vite: A fast build tool and development server.
  • Imgur API: For fetching background images.

Installation

  1. Clone the repository:

    git clone https://github.com/danikova/event-horizon.git
  2. Navigate to the project directory:

    cd event-horizon
  3. Install the dependencies:

    npm install

Usage

To start the application locally:

npm start

Open your web browser and navigate to http://localhost:3000 to view the application.

Examples

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any improvements or new features.

License

This project is licensed under the MIT License. See the LICENSE file for more details.