19squared is a web application for creating and experiencing interactive 360° tours in extended reality environments.
...
...
@@ -13,7 +13,7 @@
***Customisation:** Tailor tours to your specific needs and preferences.
***Web-Based Platform:** Accessible from any device with a web browser on smartphones, tablets, laptops, and head-mounted displays.
## Quick Start Guide
# Quick Start Guide
This guide will walk you through creating your first interactive tour on 19squared.
...
...
@@ -36,11 +36,11 @@ This guide will walk you through creating your first interactive tour on 19squar
**Congratulations!** You've created your first tour on 19squared. Explore the platform's other features to enhance your tours with additional images, interactive elements, and more.
## Developer Guide
# Developer Guide
The developer guide is a comprehensive resource for developers who want to contribute to the 19squared project.
### Code Structure
## Code Structure
```
🌱 interactive360vr
...
...
@@ -57,7 +57,7 @@ The developer guide is a comprehensive resource for developers who want to contr
└── 🔧 .env.template
```
### Installation and Docker Container
## Installation and Docker Container
After running `docker compose up -d`, the server is now running the following containers by default:
...
...
@@ -68,7 +68,7 @@ After running `docker compose up -d`, the server is now running the following co
@@ -79,12 +79,12 @@ To make your application accessible, you'll want to route external traffic to th
***Adding SSL certificates:** Secure the application with free Let's Encrypt certificates.
***Managing multiple applications:** Centralize configuration for multiple containerized services.
#### Garbage Collector
### Garbage Collector
The asset management system includes a garbage collector, accessible via the endpoint `/garbage_collector`. This mechanism is designed to reclaim storage capacity by periodically purging unreferenced assets. Integrating the garbage collector into a routine cron job schedule can optimise server storage utilisation.
For details about the development server, please refer to the project's [README](https://git.rwth-aachen.de/medialab/interactive360vr/-/blob/main/README.md) file.
### Contribution Guidelines
## Contribution Guidelines
To get started as a developer, refer to the project's [CONTRIBUTING](https://git.rwth-aachen.de/medialab/interactive360vr/-/blob/main/CONTRIBUTING.md) file. It provides a detailed guide on how to contribute code, report issues, and follow best practices.