---
myst:
  html_meta:
    "description": "Documentation for Polygonal, an online editor for polygon surface meshes."
---

# Welcome

Welcome to the documentation for [Polygonal](https://polygonal.app), an online editor for polygon surface meshes. You can use Polygonal to:

- Triangulate a polygon mesh
- Refine the surface using subdivision
- Improve the shape and size of triangles by remeshing
- Reduce the number of triangles
- Import and export meshes in STL, OBJ, OFF file formats

## Getting Started

Polygonal is an application that runs in your browser. Just go to <https://polygonal.app/run> to start the application. Although Polygonal can run on any type of device (desktop, tablet, phone), it is best supported on desktops and laptops. Having a full keyboard and mouse or touchpad will give you the best user experience.

Even though Polygonal runs in a browser, all your data stays on your computer. Once the application is loaded, you can disconnect from the internet and work offline. None of your files ever leaves your computer.

## Mesh Types

As the name implies, Polygonal can work with arbitrary polygon meshes. This in contrast to many other applications that only support triangle or quad meshes. However, some operations such as remeshing or decimation require a triangle mesh. In that case, apply the triangulation filter first.

Polygonal only supports 2-manifold surface meshes with well-defined connectivity. Polygonal does not support non-manifold meshes.

## Feedback

We're glad to hear your feedback. Drop us a mail at [<info@polygonal.app>](mailto:info@polygonal.app).

```{warning}
Polygonal is in early development. Consider it experimental software. Use at your own risk.
```

```{toctree}
---
hidden:
---

basics
filters/index
```