JuliaGeometry · popersson · Jan 27, 2026 · Dec 31, 2025 · Dec 31, 2025 · Dec 31, 2025
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -3,10 +3,10 @@ env:
   JULIA_NUM_THREADS: 2
 on:
   push:
-    branches: [master]
-    tags: ['*']
-  pull_request:
-  workflow_dispatch:
+    branches:
+      - master
+      - 'v0.2-revamp'
+    tags: '*'
 jobs:
   test:
     name: Julia ${{ matrix.version }} - ${{ matrix.os }} - ${{ matrix.arch }} - ${{ github.event_name }}

diff --git a/.gitignore b/.gitignore
@@ -3,7 +3,9 @@
 *.jl.mem
 *.jl.*.mem
 .DS_Store
-/Manifest.toml
+Manifest.toml
 /dev/
 /docs/build/
 /docs/site/
+/docs/src/examples.md
+/docs/src/*.jl
diff --git a/LICENSE b/LICENSE
diff --git a/Project.toml b/Project.toml
@@ -1,22 +1,37 @@
 name = "DistMesh"
 uuid = "f7ee28b6-bfbf-11e9-3e31-8961b86f052c"
-authors = ["Steve Kelly <kd2cca@gmail.com>"]
-version = "0.1.0"
+license = "MIT"
+version = "0.2.0"
+authors = ["Per-Olof Persson <persson@berkeley.edu>"]
 
 [deps]
-GeometryBasics = "5c1252a2-5f33-56bf-86c9-59e7332b4326"
+Delaunator = "466f8f70-d5e3-4806-ac0b-a54b75a91218"
 LinearAlgebra = "37e2e46d-f89d-539d-b4ee-838fcccc9c8e"
-TetGen = "c5d3f3f7-f850-59f6-8a2e-ffc6dc1317ea"
+StaticArrays = "90137ffa-7385-5640-81b9-e52037218182"
+
+[weakdeps]
+GeometryBasics = "5c1252a2-5f33-56bf-86c9-59e7332b4326"
+CairoMakie = "13f3f980-e62b-5c42-98c6-ff1f3baf88f0"
+GLMakie = "e9467ef8-e4e7-5192-8a1a-b1aee30e663a"
+Plots = "91a5bcdd-55d7-5caf-9e0b-520d859cae80"
+
+[extensions]
+DistMeshCairoMakieExt = "CairoMakie"
+DistMeshGLMakieExt = ["GLMakie", "GeometryBasics"]
+DistMeshPlotsExt = "Plots"
 
 [compat]
-julia = "1.6"
-GeometryBasics = "0.4"
-TetGen = "1"
+CairoMakie = "0.15"
+Delaunator = "0.1"
+GLMakie = "0.11, 0.12, 0.13"
+LinearAlgebra = "1"
+Plots = "1"
+StaticArrays = "1.9"
+julia = "1.10"
 
 [extras]
-GeometryBasics = "5c1252a2-5f33-56bf-86c9-59e7332b4326"
+CairoMakie = "13f3f980-e62b-5c42-98c6-ff1f3baf88f0"
 Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40"
-TetGen = "c5d3f3f7-f850-59f6-8a2e-ffc6dc1317ea"
 
 [targets]
-test = ["Test", "GeometryBasics", "TetGen"]
+test = ["Test", "CairoMakie"]
diff --git a/README.md b/README.md
@@ -1,10 +1,66 @@
-# DistMesh
+# DistMesh.jl
 
 [![Dev](https://img.shields.io/badge/docs-dev-blue.svg)](https://distmesh.juliageometry.org/dev)
 [![Codecov](https://codecov.io/gh/juliageometry/DistMesh.jl/branch/master/graph/badge.svg)](https://codecov.io/gh/juliageometry/DistMesh.jl)
 
-The package provides a Julia port of the [DistMesh](http://persson.berkeley.edu/distmesh/) algorithm developed by [Per-Olof Persson](http://persson.berkeley.edu/).
+**DistMesh.jl** is a Julia generator for unstructured triangular and tetrahedral meshes. It uses [Signed Distance Functions](https://en.wikipedia.org/wiki/Signed_distance_function) (SDFs) to define geometries, enabling the generation of high-quality, isotropic meshes for complex shapes defined by simple mathematical functions.
 
-There have been several improvements made to improve performance and output quality from the original Matlab version.
+Primary use cases include Finite Element Analysis (FEA), computational fluid dynamics, and geometric modeling.
 
-[Technical Report](https://sjkellyorg.files.wordpress.com/2020/11/distmesh_sjkelly.pdf)
+---
+
+## Note on Version 0.2.0
+
+Version 0.2.0 represents a major rewrite of `DistMesh.jl`, focusing on replicating the original 2D code but with better performance, native Julia implementations, and integration with the Makie/Plots ecosystems. **This version is now fully MIT licensed.**
+
+**Legacy Support:** The original N-dimensional meshing code port has been retired in this version to allow for a cleaner architecture. If you require the legacy `distmeshnd` functionality, please pin your package version to v0.1:
+
+```julia
+] add DistMesh@0.1
+```
+
+---
+
+## Quick Start
+
+The core function `distmesh2d` generates a mesh based on a distance function, a relative size function, an initial edge length, and a bounding box.
+
+The code below generates a mesh of the unit circle:
+
+```julia
+using DistMesh
+
+# Generate mesh: Distance function, size function, resolution, bounding box
+msh = distmesh2d(dcircle, huniform, 0.2, ((-1,-1), (1,1)))
+```
+
+```text
+DMesh: 2D, 88 nodes, 143 triangle elements
+```
+
+Optionally, the mesh can be visualized using various plotting packages:
+
+```julia
+using GLMakie # or Plots, or CairoMakie
+
+plot(msh)
+```
+
+![Triangular mesh of the unit circle](circle_mesh.png)
+
+For more details and extensive examples, please see the [DistMesh documentation](https://distmesh.juliageometry.org).
+
+---
+
+## Background
+
+This package is a Julia port of the [DistMesh](http://persson.berkeley.edu/distmesh/) algorithm developed by [Per-Olof Persson](http://persson.berkeley.edu/). Significant improvements have been made to performance and type stability compared to the original MATLAB implementation. The algorithm is described in the following publications:
+
+* P.-O. Persson, G. Strang, *[A Simple Mesh Generator in MATLAB](https://persson.berkeley.edu/distmesh/persson04mesh.pdf)*. SIAM Review, Volume 46 (2), pp. 329-345, June 2004.
+* P.-O. Persson, *[Mesh Generation for Implicit Geometries](https://persson.berkeley.edu/thesis/persson-thesis-color.pdf)*. Ph.D. thesis, Department of Mathematics, MIT, Dec 2004.
+
+---
+
+## Related Packages
+
+Several other implementations of the DistMesh algorithm exist in the Julia ecosystem, including [DistMesh-Julia](https://github.com/precise-simulation/distmesh-julia) and [DistMesh2D.jl](https://juliapackages.com/p/distmesh2d). Please consider checking these packages if DistMesh.jl does not meet your specific requirements.
diff --git a/bench/.gitignore b/bench/.gitignore
diff --git a/bench/benchmarks.jl b/bench/benchmarks.jl
diff --git a/bench/hilbert_perf.jl b/bench/hilbert_perf.jl
diff --git a/bench/perf.jl b/bench/perf.jl
diff --git a/bench/profile.jl b/bench/profile.jl
diff --git a/bench/util.jl b/bench/util.jl
diff --git a/circle_mesh.png b/circle_mesh.png
diff --git a/docs/Project.toml b/docs/Project.toml
@@ -1,3 +1,11 @@
 [deps]
+CairoMakie = "13f3f980-e62b-5c42-98c6-ff1f3baf88f0"
+DistMesh = "f7ee28b6-bfbf-11e9-3e31-8961b86f052c"
 Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
 GeometryBasics = "5c1252a2-5f33-56bf-86c9-59e7332b4326"
+Literate = "98b081ad-f1c9-55d3-8b20-4c87d4299306"
+StaticArrays = "90137ffa-7385-5640-81b9-e52037218182"
+
+[compat]
+CairoMakie = "0.15"
+Documenter = "1"