---
url: /blog/posts/2026-03-25-announcing-pglite-v04.md
description: >-
  PGlite v0.4 adds PostGIS, connection multiplexing, and a refactored
  architecture that decouples initdb from the main WASM binary.
---

PGlite v0.4 is out. This release brings PostGIS support, connection multiplexing, and a major architectural refactor that decouples `initdb` from the main WASM binary — setting up PGlite's foundation for native ports and multi-connection support.

PGlite now sees over 13 million weekly downloads across all packages. From CI testing to [vibe coding with a database in the sandbox](https://electric-sql.com/blog/2025/06/05/database-in-the-sandbox), PGlite is showing up everywhere. Here's what's new.

> \[!WARNING] 🪧  Quicklinks
> [PGlite](https://pglite.dev/) is a WASM build of Postgres that runs inside your JavaScript environment — in the browser, Node.js, Bun, and Deno.
>
> * [v0.4 release on GitHub](https://github.com/electric-sql/pglite/releases)
> * [Extension catalog](https://pglite.dev/extensions/)
> * [Discord](https://discord.gg/pVASdMED) · [GitHub](https://github.com/electric-sql/pglite/)

## What's new in v0.4

### A cleaner architecture

A guiding principle for PGlite is keeping our [Postgres fork](https://github.com/electric-sql/postgres-pglite) as close to upstream as possible. The less we change, the easier it is to upgrade, maintain, and accept contributions. We rely on [vanilla Emscripten](https://emscripten.org/) for the build and keep external build dependencies in a [Docker builder](https://hub.docker.com/r/electricsql/pglite-builder) so the environment is reproducible on any host.

The biggest win in v0.4 is refactoring how `initdb` works. Previously, `initdb` was embedded inside the final WASM executable, requiring hacks that had to be maintained across fork updates. Now, `initdb` runs as a separate WASM process. PGlite intercepts its system calls to provide the necessary plumbing — stdin/stdout redirection and filesystem sharing via Emscripten's [PROXYFS](https://emscripten.org/docs/api_reference/Filesystem-API.html#filesystem-api-proxyfs) — without changing any `initdb` code.

This mirrors how a native PostgreSQL deployment works, making the codebase easier to understand for new contributors. The same pattern extends to other Postgres client tools without needing changes to their code.

### PostGIS

[PostGIS](https://postgis.net/) adds support for storing, indexing, and querying geospatial data. For many developers, it's the reason they choose Postgres. Now it runs in PGlite.

Getting here wasn't trivial. PostGIS has many dependencies, all of which needed WASM builds. Chrome's [8MB limit on synchronously loading dynamic libraries](https://chromestatus.com/feature/5099433642950656) added another constraint. The community stepped in and helped us deliver it.

Thanks to [@StachowiakDawid](https://github.com/StachowiakDawid) and [@larsmennen](https://github.com/larsmennen) for their work on this.

### Connection multiplexing

PGlite runs in Postgres [single-user mode](https://www.postgresql.org/docs/current/app-postgres.html), which means a single connection. Many client tools expect to open multiple connections, and this has been a friction point.

[@nickfujita](https://github.com/nickfujita) contributed a PR that multiplexes concurrent connections over PGlite's single connection. This unblocks compatibility with tooling that previously couldn't work with PGlite's single-connection constraint.

### Community extensions

The community has taken our [extension build docs](https://pglite.dev/extensions/development#building-postgres-extensions) and run with them. Extensions now shipping in production include [pg\_uuidv7](https://github.com/fboulnois/pg_uuidv7), [pgTAP](https://pgtap.org/), [pg\_hashids](https://github.com/iCyberon/pg_hashids), and [Apache AGE](https://github.com/electric-sql/pglite/pull/860). Thanks also to [@loredanacirstea](https://github.com/loredanacirstea) for help bringing [pgcrypto](https://www.postgresql.org/docs/current/pgcrypto.html) to PGlite.

These come on top of the contrib extensions we bundle by default. See the full [extension catalog](https://pglite.dev/extensions/).

## Growth

Over the past year, PGlite has grown from ~500k to over 13 million weekly downloads across all packages. [Prisma](https://www.prisma.io/) now [bundles PGlite](https://www.prisma.io/docs/postgres/database/local-development) in their CLI for local development — try it with `npx prisma dev`. We're seeing more community activity [on HN](https://news.ycombinator.com/item?id=46146133), more external PRs on [GitHub](https://github.com/electric-sql/pglite/), and adoption across CI/CD pipelines, browser-based IDEs, and developer tooling.

## Get started

Install PGlite:

```bash
npm install @electric-sql/pglite
```

Basic usage:

```typescript
import { PGlite } from '@electric-sql/pglite'

const db = new PGlite()
await db.exec('CREATE TABLE test (id serial PRIMARY KEY, name text)')
await db.exec("INSERT INTO test (name) VALUES ('hello')")
const result = await db.query('SELECT * FROM test')
```

Check out the [extension catalog](https://pglite.dev/extensions/) to add PostGIS, pgvector, and more.

## Coming next

* **libpglite** — a native library built directly from Postgres source, with bindings for multiple languages. This unlocks mobile and desktop use cases, starting with React Native.
* **Multi-instance** — true multi-connection support, exploring both cooperative and multi-threaded (WebWorker) approaches. We're also monitoring the [threading work in Postgres](https://wiki.postgresql.org/wiki/Multithreading) as a longer-term path.
* **Replication** — enabling Postgres logical replication to expand what PGlite can participate in.

***

Join us on [Discord](https://discord.gg/pVASdMED), star us on [GitHub](https://github.com/electric-sql/pglite/), and check out the [PGlite docs](https://pglite.dev/) to get started.

Many thanks to all our contributors and users — your support keeps us going.