Skip to content

An opensource webapp that allows users to explore historical versions of their current location virtually. Using augmented reality and historical maps, users can see how their surroundings looked in different time periods and learn about the history of the area.

License

Notifications You must be signed in to change notification settings

Akshatchaube01/TimeWarp

Repository files navigation

TimeWarp

Understanding history, embracing the present, and envisioning the future


View Demo


timewarp

Time Warp is an open-source web application that enables users to explore historical versions of their current location virtually. By leveraging augmented reality and historical maps, users can visualize how their surroundings appeared in different time periods and delve into the area's rich history.


Table of Contents

  1. Features
  2. Tech Stack
  3. React + Vite
  4. Prerequisites
  5. How to Contribute
  6. Code of Conduct
  7. Alternative Way
  8. Our Vision
  9. Learn More
  10. Feedback and Support

Features

  • Simulations: Step into pivotal moments in history through immersive simulations.
  • Historical Reenactments: Experience the sights and sounds of bygone eras through interactive reenactments.
  • Futuristic Scenarios: Peer into potential futures with speculative scenarios and advanced technologies.

With Time Warp, the past, present, and future converge in a captivating journey through time, inviting users to explore, learn, and imagine the possibilities.

Tech Stack

Time Warp utilizes the following technologies:

  • HTML: Provides the structure for web pages.
  • CSS: Styles the appearance of web pages, ensuring a visually appealing user experience.
  • JavaScript: Adds interactivity and functionality to the web application.
  • Three.js: A JavaScript library used for creating and displaying 3D content in web browsers.
  • React.js: A JavaScript library for building user interfaces, enabling efficient development of dynamic and interactive web applications.
  • Virtual Reality: Integration of virtual reality technology to create immersive experiences.
  • Augmented Reality Applications: Implementation of augmented reality technology to enhance user interactions and provide innovative features such as exploring historical environments and visualizing past landscapes in real-time.

React + Vite

This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.

Currently, two official plugins are available:

Prerequisites

Before installation, please ensure you have the following tools installed:

  • Git - Learn Git step-by-step by following the instructions provided here.

Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

How to Contribute

We welcome contributions! Please see our Contributing Guide for detailed instructions on how to get started.

If you think that you can add a new feature or want to fix a bug, we invite you to contribute to Timewarp and make this project better. To contribute:

  1. Create a folder at your desire location (usually at your desktop).

  2. Open Git Bash Here

  3. Create a Git repository.

    Run command git init

  4. Fork the repository.

  5. Clone your forked repository of project.

git clone https://github.com/<your_username>/TimeWarp.git
  1. Navigate to the project directory.
cd TimeWarp
  1. Add a reference(remote) to the original repository.
git remote add upstream https://github.com/Akshatchaube01/TimeWarp.git
  1. Check the remotes for this repository.
git remote -v
  1. Always take a pull from the upstream repository to your main branch to keep it updated as per the main project repository.
git pull upstream main
  1. Create a new branch(prefer a branch name that relates to your assigned issue).
git checkout -b <YOUR_BRANCH_NAME>
  1. Perform your desired changes to the code base.

  2. Check your changes.

git status
git  diff
  1. Stage your changes.
git add . <\files_that_you_made_changes>
  1. Commit your changes.
git commit -m "relavant message"
  1. Push the committed changes in your feature branch to your remote repository.
git push -u origin <your_branch_name>
  1. To create a pull request, click on compare and pull requests.

  2. Add an appropriate title and description to your PR explaining your changes.

  3. Click on Create pull request.

Alternative Way

Follow the below instructions you can use GitHub Desktop to manage this repository. Here's how:

  1. Download and Install GitHub Desktop:

    • Go to the GitHub Desktop website and download the GitHub Desktop application.
    • Follow the installation instructions to install GitHub Desktop on your computer.
  2. Clone the Repository:

    • Open GitHub Desktop and sign in to your GitHub account.
    • Click on the "File" menu, then select "Clone Repository..."
    • Choose the repository you want to clone from the list or enter its URL.
    • Choose the local path where you want to clone the repository and click "Clone".
  3. Make Changes:

    • After cloning the repository, you can make changes to the files locally using your preferred code editor.
  4. Commit Changes:

    • Once you've made changes, open GitHub Desktop.
    • You'll see a list of files with changes. Write a summary and description of your changes in the text fields.
    • Click "Commit to main" to commit your changes locally.
  5. Push Changes:

    • To push your changes to the remote repository on GitHub.com, click "Push origin".
  6. Pull Changes:

    • If there are changes on the remote repository that you don't have locally, you can pull them by clicking "Fetch origin" or "Pull origin".
  7. Sync Changes:

    • To synchronize your local repository with the remote repository, click "Sync" to push and pull changes in one step.

That's it! You can now use GitHub Desktop to manage this repository efficiently.

Our Vision

With innovation as our compass and authenticity as our guide, we are committed to delivering engaging content and immersive experiences that bridge the gap between the past, present, and future. Our mission is to empower individuals to engage with history in meaningful and transformative ways, becoming stewards of their own narratives and architects of a brighter tomorrow.

Learn More

For more information about the project and how it works, please refer to our Learn Guide.

Feedback and Support

If you encounter any issues or have any feedback or suggestions, please open an issue in the Issues section of this repository. We appreciate your feedback and will respond as soon as possible.

Code of Conduct

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

License

This project is licensed under the MIT License - see the LICENSE file for details.


Contributors

Thanks to all contributors for helping this project grow! 🍻


Support

Don't forget to leave a star for this project!

GitHub stars GitHub forks GitHub issues GitHub closed issues GitHub pull requests GitHub release (latest by date)

About

An opensource webapp that allows users to explore historical versions of their current location virtually. Using augmented reality and historical maps, users can see how their surroundings looked in different time periods and learn about the history of the area.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published