Geometrica is a tool for visualising tilings of the Euclidean plane and the landscapes of hyperbolic and elliptic spaces.
This project is built in two phases. This approach sets a solid foundation before moving on to more complex architectural and technical work.
🚧 The project is currently in Phase I: the foundation phase.
This phase focuses on the core rendering logic and visualisation algorithms using simple, direct technology: plain HTML, CSS and JavaScript. It prioritises rapid prototyping and a clear understanding of the graphics concepts that will underpin the application.
As the project is in Phase I, there are no build tools or installation steps.
-
Clone this repository:
git clone https://github.com/Tarawally/geometrica.git
-
Go to the project directory:
cd geometrica -
Open the main HTML file in your web browser:
- Go to the
public/folder. - Open
index.html.
- Go to the
This project is developed with a strong emphasis on up‑front design and a transparent architectural process. The journey from high‑level sketches to detailed feature design is documented and version‑controlled in the /docs directory.
This directory is an Obsidian vault that serves as the project’s “second brain” and includes:
- The project whiteboard: the initial visual brainstorm and dependency map.
- The development roadmap: the “Learning Ladder” that sequences the project’s features.
- Detailed design logs: formal design documents for every feature, written before the code, following a progressive formalisation model inspired by C4.
- A personal wiki: a growing knowledge base of the technical concepts involved.
Please note: the documentation uses Obsidian’s [[WikiLink]] format, which may not be navigable directly on the GitHub website.
This project is licensed under the MIT License. You are free to use, modify and learn from the code and documentation. See the LICENSE file for full details.