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.
- Features
- Tech Stack
- React + Vite
- Prerequisites
- How to Contribute
- Code of Conduct
- Alternative Way
- Our Vision
- Learn More
- Feedback and Support
- 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.
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.
This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
Currently, two official plugins are available:
- @vitejs/plugin-react uses Babel for Fast Refresh
- @vitejs/plugin-react-swc uses SWC for Fast Refresh
Before installation, please ensure you have the following tools installed:
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.
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:
-
Create a folder at your desire location (usually at your desktop).
-
Open Git Bash Here
-
Create a Git repository.
Run command
git init -
Fork the repository.
-
Clone your forked repository of project.
git clone https://github.com/<your_username>/TimeWarp.git
- Navigate to the project directory.
cd TimeWarp
- Add a reference(remote) to the original repository.
git remote add upstream https://github.com/Akshatchaube01/TimeWarp.git
- Check the remotes for this repository.
git remote -v
- 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
- Create a new branch(prefer a branch name that relates to your assigned issue).
git checkout -b <YOUR_BRANCH_NAME>
-
Perform your desired changes to the code base.
-
Check your changes.
git status
git diff
- Stage your changes.
git add . <\files_that_you_made_changes>
- Commit your changes.
git commit -m "relavant message"
- Push the committed changes in your feature branch to your remote repository.
git push -u origin <your_branch_name>
-
To create a pull request, click on
compare and pull requests. -
Add an appropriate title and description to your PR explaining your changes.
-
Click on
Create pull request.
Follow the below instructions you can use GitHub Desktop to manage this repository. Here's how:
-
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.
-
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".
-
Make Changes:
- After cloning the repository, you can make changes to the files locally using your preferred code editor.
-
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.
-
Push Changes:
- To push your changes to the remote repository on GitHub.com, click "Push origin".
-
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".
-
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.
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.
For more information about the project and how it works, please refer to our Learn Guide.
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.
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.
This project is licensed under the MIT License - see the LICENSE file for details.
Thanks to all contributors for helping this project grow! 🍻
for this project!
