AxioDB is an embedded NoSQL database for Node.js with MongoDB-style queries. It is a pure JavaScript alternative to SQLite with zero native dependencies, no node-gyp compilation, and no platform-specific binaries. Install with 'npm install axiodb' and you have a database — no mongod process, no server setup. Perfect for Electron apps, CLI tools, and local-first applications.

Is AxioDB a replacement for MongoDB?

No. AxioDB is embedded — it runs inside your app with no server. MongoDB is a client-server database for multi-user production systems. Use AxioDB for desktop apps, CLI tools, and local-first applications with 10K–500K documents. Use MongoDB when you need a shared, networked, multi-user database.

Does AxioDB work with Electron?

Yes — Electron is the primary use case AxioDB was built for. Zero native dependencies means no electron-rebuild, no platform-specific .node files, no node-gyp compilation. Just npm install axiodb and it works on Windows, Mac, and Linux without any rebuild step.

What is the difference between AxioDB and better-sqlite3?

better-sqlite3 uses C native bindings and requires compilation via node-gyp. AxioDB is pure JavaScript — it installs in any Node.js environment without compilation or platform-specific builds. AxioDB also uses NoSQL/JSON document queries instead of SQL strings, includes built-in caching and Worker Threads, and works out of the box in Electron without electron-rebuild.

What is the difference between AxioDB and lowdb?

lowdb stores everything in a single JSON file and becomes slow above 1,000–5,000 records due to full-file reads on every operation. AxioDB uses file-per-document tree storage with InMemoryCache, Worker Threads, and auto-indexing — optimized for 10,000–500,000 documents with O(1) lookups by ID and fast filtered queries.

What is the difference between AxioDB and nedb?

NeDB is abandoned (no active maintenance since 2016) and keeps the entire database in memory. AxioDB is actively maintained, uses file-based storage, supports TypeScript, ACID transactions with savepoints and WAL, Worker Threads, AES-256 encryption, custom field indexing, and AxioDBCloud remote access.

How many documents can AxioDB handle?

AxioDB is optimized for 10,000–500,000 documents per collection. For 1M+ documents, migrate to PostgreSQL or MongoDB. AxioDB's InMemoryCache and Worker Threads keep performance fast within this range — documentId lookups take ~1ms and indexed queries take ~2ms on 10,000 documents.

Does AxioDB support TypeScript?

Yes. Full TypeScript type definitions are included out of the box with the axiodb npm package. No @types/axiodb needed.

Does AxioDB work in the browser?

No. AxioDB requires Node.js (v20+) and uses the filesystem for storage. It is a server-side and desktop embedded database. It does not run in browsers.

AxioDBCloud is a TCP-based remote access layer for AxioDB. Deploy AxioDB in Docker or Cloud, then connect from multiple clients using the exact same API as embedded AxioDB — zero code changes. Supports 1,000+ concurrent connections, auto-reconnect with exponential backoff, and heartbeat monitoring.

SEE HOW AXIODB HAS EVOLVED

Changelog

Every major milestone in AxioDB's history, from the very first commit onward. This is a curated list of what actually changed - not every commit or patch bump, just the releases that shipped something meaningful.

v11.9.13+

2026-07-11

AxioDBCloud connection pooling, rate limiting & TLS

•Connection pooling for AxioDBCloud with least-busy routing (fewest in-flight requests) instead of round-robin
•Per-IP concurrent connection cap and connection-attempt rate limiting on the TCP server
•TLS/SSL encryption support for TCP connections
•RBAC and TCP Auth test gates added to CI
•SEO metadata integrated across all documentation pages

v9.7.7

2026-07-10

Session-based GUI auth & TCP authentication

•Session-based authentication with cookie support for the Control Server GUI
•TCP authentication (RBAC) and index management commands added to AxioDBCloud

v9.6.1

2026-03-27

AxioDB constructor refactor

•AxioDB constructor refactored to accept a single options object instead of positional arguments

v8.33.235

2026-03-23

ACID compliance milestone & CI matrix testing

•Pseudo-ACID transaction compliance across CRUD operations
•CI test matrix expanded across multiple Node.js versions
•Query optimization in Reader and Searcher classes

v7.33.234

2026-03-15

Path-traversal hardening

•DocumentLoader and PathSanitizer utilities added to centralize safe file handling
•Formal contributor rules and development guidelines added to the repo

v6.33.128

2026-03-13

AxioDBCloud (TCP remote access) begins

•TCP server and ConnectionManager implemented - the foundation of AxioDBCloud remote access
•Protocol error handling and HTTP-vs-TCP-port misconfiguration detection

v6.33.127

2026-03-11

Smarter caching & index cleanup

•Selective cache invalidation and randomized TTL to avoid cache-stampede synchronization
•DeleteIndex service for removing documents from indexes
•IndexCache gained TTL-based expiry and cleanup

v5.33.127

2026-03-10

ACID transactions with Write-Ahead Log

•TransactionIndexManager, TransactionRegistry, and Write-Ahead Log (WAL) services implemented
•Foundation for session-based transactions with commit/rollback

v3.31.104

2025-10-31

Worker-thread performance overhaul

•File processing parallelized with Promise.all across worker threads
•Reader/search operations tuned to use all available CPU cores
•Sorting utility optimized to use native comparison

v2.30.93

2025-08-31

Database export/import

•Database export as a compressed .tar.gz archive
•Database import from an uploaded archive
•Advanced JSON query search support

v2.28.81

2025-08-24

API reference page & transaction tokens

•API reference documentation page added to the Control Server GUI
•Transaction token support added to the HTTP API

v2.28.77

2025-08-20

Dashboard caching & transaction tokens

•Caching and transaction token support for collections and databases
•Dashboard stats retrieval integrated with the cache layer

v2.24.71

2025-08-11

Full CRUD document management UI

•Create, read, update, delete, and aggregate operations added to the Control Server GUI as modal-driven workflows
•Advanced search with JSON query and document-ID lookup in the Documents page

v2.19.65

2025-07-27

Database management UI & JWT key management

•Database management routes/controller and GUI dashboard (Zustand state management)
•JWT-based key management for database instances

v2.18.54

2025-06-23

Engine refactor & worker-based search

•Legacy FileManager/FolderManager replaced by the current engine/ module structure
•HashmapSearch replaced by worker-thread-based Searcher for parallel file reads

v2.13.47

2025-06-21

Control Server (HTTP GUI) foundation

•AxioDB Control Server implemented on Fastify with health check and routes endpoints
•Tailwind CSS integrated into the GUI

v2.11.29

2025-06-14

GUI authentication & schema validation

•JWT-based authentication checks added to the GUI
•Schema validation for user registration and collection data

v2.10.19

2025-06-08

Initial Docker support

•First Docker setup: package.json, tsconfig.json, and a schema generator utility for containerized deployments

v1.5.8

2025-04-02

Cache invalidation on writes

•Cache clearing wired into update and delete operations, and a clearAllCache method added

v1.4.3

2025-03-26

Aggregation pipelines

•aggregate() method added to Collection with MongoDB-style pipeline stages
•$match filtering extended to support regex and object matching

v1.3.9

2025-03-20

Full CRUD operation suite

•Reader class: query, sort, skip/limit pagination, and total-count support
•DeleteOperation: deleteOne and deleteMany with detailed error handling
•UpdateOperation: UpdateOne and UpdateMany with schema-aware partial updates

v1.1.4

2025-02-28

Encryption support

•CryptoHelper class added for AES encryption/decryption of collection data

v1.1.2

2025-02-14

Core Collection & Database classes

•Collection and Database classes implemented - the foundation of the document store
•FileManager/FolderManager error handling improved

v1.0.16

2024-12-25

Initial Web GUI

•First GUI setup with Vite and React, alongside a server-file restructure

v1.0.14

2024-12-23

In-memory caching

•InMemoryCache class added, with TTL-based expiry for cached query results

v1.0.0

2024-12-07

Fastify server & first insert

•Fastify HTTP server integrated into the project
•The `Configuration` class was renamed to `AxioDB`
•First working document insert feature

v1.0.0

2024-10-01

Project inception

•Initial commit: repository scaffolding, FileManager/FolderManager engine, and an initial `Configuration` class (later renamed to `AxioDB`)