# MyFrac

> Fractal art exploration website with real-time GPU rendering

## Overview

MyFrac is a web-based fractal art generator that runs entirely in the browser using WebGL. It enables users to explore, create, and collect mathematical fractal art without any installation or backend processing.

## Pages

- [Home](https://myfrac.app/en): Featured fractal gallery and entry point
- [Explore](https://myfrac.app/en/explore): Interactive fractal renderer with 94 formulas, real-time controls, and export
- [Gallery](https://myfrac.app/en/gallery): Personal collection manager for saved fractals
- [About](https://myfrac.app/en/about): Project information and technology stack

## Core Features

- **94 Built-in Formulas**: Mandelbrot, Julia, Burning Ship, Tricorn, Phoenix, Newton, Magnet, Lambda, McMullen, rational, transcendental, and more
- **7 Transform Plugins**: Kaleidoscope, Möbius, Inversion, Polar, Sinusoidal, Spherical, None
- **Custom Formula Editor**: Write fractal formulas using Fractint-style .frm compatibility and MyFrac native directives with real-time compilation
- **Coloring System**: 9 coloring modes with orbit channel support
- **Real-time Rendering**: WebGL GPU acceleration with 2x2 SSAA option
- **High-res Export**: PNG export up to 4x resolution
- **Personal Gallery**: Save fractals to localStorage with thumbnails, star favorites, import/export collections
- **Bilingual**: English and Chinese (中文) support

## Technology Stack

- Next.js 16 (App Router, Turbopack)
- React 19 + TypeScript 5
- WebGL 1 (GLSL fragment shaders)
- Tailwind CSS 4 + shadcn/ui
- next-intl (i18n)
- CodeMirror 6 (formula editor)

## Formula Syntax (Fractint .frm)

Users can write custom formulas using Fractint .frm syntax:

```
MyFormula {
  init:
    z = 0
  loop:
    z = z^2 + c
  bailout:
    |z| < 4
}
```

Supported: sections (init, loop, bailout), variables (z, c, pixel, p1-p5), fn1-fn4 function slots, operators (+, -, *, /, ^), functions (sin, cos, exp, log, abs, conj, sqr, etc.), if/elseif/else/endif, and native metadata directives.

## URL Parameters

Fractal state is fully URL-serializable. Key parameters:
- `formula`: formula ID (e.g., mandelbrot, julia, newton3)
- `cX`, `cY`: center coordinates
- `zoom`: zoom level
- `iter`: max iterations
- `palette`: color palette index (0-4)
- `coloring`: outside coloring mode
- `inside`: inside coloring mode

Full documentation: https://myfrac.app/llms-full.txt