Skip to content

xenitane/geo-vis

Repository files navigation

Geo-Vis

A simple web application for rendering geometric visuals, attractors, complex sets and much more along the way Live at https://xenitane.github.io/geo-vis

Table of Contents

Inspiration

One day, as I was on YouTube, watching some math videos from 3blue1brown, I was introduced to the concept of fractal geometry.

The beauty of these simple yet so intricate shapes took me by surprise and since then I wanted to build my collection of them.

And this project is just what is helping me to realize that goal.

Challanges

  • Writing the abstraction for the renderers for different purposes.
  • Implementing the three-dimensional hamilton space filling curve for color spaces to color the fractals.
  • Optimizing some L-Systems for optimal performance and desired shapes
  • And some weird Mathematics which I'm glad I gave time to.

Technology

HTML5CSS3JavaScriptTypeScriptSVGNodeJSReactViteGithub ActionsGithub PagesTailwindCSSshadcn/ui

Installation and Usage

Requirements

  • NodeJS version 18 or higher
  • npm version 10

Usage Instructions

  1. To run the development server

    git clone https://www.github.com/xenitane/geo-vis.git geo-vis
    cd geo-vis
    npm ci
    npm run dev
  2. Build and Preview

    npm run build
    npm run preview
  3. Linting, Formatting and Type-Checking

    npm run lint
    npm run format
    npm run type-check

Other Instructions

There are several config files in the repository, modify them as per your needs.

Contributors

To contribute to the project, just raise an issue, a pull request, or reach out.

GitHub package.json version (subfolder of monorepo) GitHub issuesGitHub License