An advanced light-weight database FeatherDB
npm install featherdbFeatherDB is a lightweight, privacy-first, fully local encrypted database for Node.js.
Your data never leaves your machine. No cloud. No servers. No accounts.
---
Most databases require you to trust third-party services or run heavy servers.
FeatherDB is built for developers who want full control over their data.
- No MongoDB
- No external services
- No telemetry
- No tracking
- No network usage
---
- Fully local file-based database
- Encrypted storage using a secret key
- Automatic compression (gzip)
- One file per model (.fdb)
- Simple schema support
- Zero required dependencies
- Event system (ready, error)
- Fast and lightweight
---
``bash`
npm install featherdb
---
`js
const FeatherDB = require("featherdb");
FeatherDB.connect("./data", "my-secret-key")
const Users = FeatherDB.model("users", {
username: String,
email: String
})
`
This will create an encrypted file:
`
data/users.fdb
---
FeatherDB never stores raw JSON.
Data flow:
1. JSON serialization
2. gzip compression
3. XOR encryption using SHA-256 derived key
4. Base64 encoding
Large datasets are stored in very small, unreadable files.
---
Each model creates its own encrypted .fdb file.
`js`
const Posts = FeatherDB.model("posts", {
title: String,
content: String
})
---
`js
FeatherDB.on("ready", info => {
console.log("Database ready:", info.folder)
})
FeatherDB.on("error", err => {
console.error("DB error:", err)
})
``
---
- Discord bots
- CLI tools
- Local dashboards
- Offline apps
- Privacy-focused software
---
> Your data should belong to you.
FeatherDB is for developers who value privacy, ownership, and simplicity.
---
MIT