{"id":13632626,"url":"https://github.com/aviondb/aviondb","last_synced_at":"2025-04-05T21:08:11.063Z","repository":{"id":44411086,"uuid":"249981301","full_name":"aviondb/aviondb","owner":"aviondb","description":"A decentralised database with MongoDB-like developer interface (Fully Compatible with OrbitDB)","archived":false,"fork":false,"pushed_at":"2023-01-07T18:30:17.000Z","size":7188,"stargazers_count":434,"open_issues_count":46,"forks_count":28,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-03-22T19:03:23.655Z","etag":null,"topics":["database","distributed-database","ipfs","javascript","mongodb-features","nodejs","orbitdb","typescript"],"latest_commit_sha":null,"homepage":"https://twitter.com/aviondb","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aviondb.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://gitcoin.co/grants/633/dappkit-firebase-for-web-30"]}},"created_at":"2020-03-25T13:08:13.000Z","updated_at":"2024-12-22T19:59:43.000Z","dependencies_parsed_at":"2023-02-07T20:45:42.358Z","dependency_job_id":null,"html_url":"https://github.com/aviondb/aviondb","commit_stats":null,"previous_names":["dappkit/ipfsdb","aviondb/aviondb","dappkit/aviondb"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aviondb%2Faviondb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aviondb%2Faviondb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aviondb%2Faviondb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aviondb%2Faviondb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aviondb","download_url":"https://codeload.github.com/aviondb/aviondb/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246237435,"owners_count":20745348,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["database","distributed-database","ipfs","javascript","mongodb-features","nodejs","orbitdb","typescript"],"created_at":"2024-08-01T22:03:09.255Z","updated_at":"2025-03-29T20:05:31.361Z","avatar_url":"https://github.com/aviondb.png","language":"TypeScript","readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://dappkit.io\" title=\"AvionDB\"\u003e\n    \u003cimg src=\"https://bafzbeiekuueascn2ltb23u4d3v2osrratsppwcur3ermbd2g6v62vmv56u.textile.space/aviondb/assets/github.png\" alt=\"AvionDB JS Implementation\" width=\"512\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch3 align=\"center\"\u003eAvionDB: A Distributed, MongoDB-like Database\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://badge.fury.io/js/aviondb\"\u003e\u003cimg src=\"https://badge.fury.io/js/aviondb.svg\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://img.shields.io/badge/Node.js-%3E%3D8.6.0-orange.svg?style=flat-square\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Node.js-%3E%3D8.6.0-orange.svg?style=flat-square\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/dappkit/aviondb/workflows/Node.js%20CI/badge.svg\"\u003e\u003cimg src=\"https://github.com/dappkit/aviondb/workflows/Node.js%20CI/badge.svg\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://david-dm.org/dappkit/aviondb\"\u003e\u003cimg src=\"https://david-dm.org/dappkit/aviondb.svg?style=flat-square\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://bundlephobia.com/result?p=aviondb\"\u003e\u003cimg src=\"https://flat.badgen.net/bundlephobia/minzip/aviondb\"\u003e\u003c/a\u003e\n\u003ca href=\"https://discord.gg/88YpNuQ\"\u003e\u003cimg src=\"https://img.shields.io/discord/616677539812868097?color=blueviolet\u0026label=discord\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n### Architecture\n\n![AvionDB Architecture](./assets/Architecture.png)\n\nAvionDB uses OrbitDB stores to model MongoDB-like Databases. It creates a notion of:\n\n- Each AvionDB instance can have several [Databases](https://github.com/dappkit/aviondb-specs#databases).\n- Each Database can have several [Collections](https://github.com/dappkit/aviondb-specs#collections).\n- Each Collection can have several [Documents](https://github.com/dappkit/aviondb-specs#documents).\n\nSee more details in the [Specs](https://github.com/dappkit/aviondb-specs).\n\n### Project status \u0026 support\n\nStatus: **in active development**\n\n**_NOTE!_** _AvionDB is **alpha-stage** software. It means AvionDB hasn't been security audited and programming APIs and data formats can still change. We encourage you to [reach out to the maintainers](https://discord.gg/88YpNuQ) if you plan to use AvionDB in mission critical systems._\n\nThis is the TypeScript implementation and it works with **Browsers**, **Node.js** \u0026 **TypeScript** with support for Linux, OS X, and Windows . The minimum required version of Node.js is now 8.6.0 due to the usage of `...` spread syntax. LTS versions (even numbered versions 8, 10, etc) are preferred.\n\n## Table of Contents\n\n\u003c!-- toc --\u003e\n\n- [Table of Contents](#table-of-contents)\n- [Install](#install)\n  - [Using NodeJS](#using-nodejs)\n  - [In a web browser](#in-a-web-browser)\n    - [through Browserify](#through-browserify)\n    - [through webpack](#through-webpack)\n    - [from CDN](#from-cdn)\n- [Usage](#usage)\n  - [Example](#example)\n- [API](#api)\n- [Development](#development)\n  - [Run Tests](#run-tests)\n  - [Benchmarks](#benchmarks)\n- [Specs](#specs)\n- [Projects using AvionDB](#projects-using-aviondb)\n- [Frequently Asked Questions](#frequently-asked-questions)\n  - [Are there implementations in other languages?](#are-there-implementations-in-other-languages)\n  - [Where can I see your Roadmap?](#where-can-i-see-your-roadmap)\n  - [What mongodb features does aviondb support?](#what-mongodb-features-does-aviondb-support)\n  - [How can I use AvionDB in my Application?](#how-can-i-use-aviondb-in-my-application)\n  - [Other Questions?](#other-questions)\n- [Contributing](#contributing)\n- [Sponsors](#sponsors)\n- [License](#license)\n\n## Install\n\nThis module uses node.js, and can be installed through npm:\n\n### Using NodeJS\n\n```\n// Using npm\nnpm install --save aviondb\n\n// Using Github\nnpm install git+https://github.com/dappkit/aviondb.git\n```\n\nWe support both the Current and Active LTS versions of Node.js. Please see [nodejs.org](https://nodejs.org/) for what these currently are. The minimum required version of Node.js is now 8.6.0 due to the usage of `...` spread syntax. LTS versions (even numbered versions 8, 10, etc) are preferred.\n\n### In a web browser\n\n#### **through Browserify**\n\nSame as in Node.js, you just have to [browserify](http://browserify.org/) to bundle the code before serving it.\n\n\u003e Note: The code uses `es6`, so you have to use [babel](https://babeljs.io/) to convert the code into `es5` before using `browserify`.\n\n#### **through webpack**\n\nSame as in Node.js, you just have to [webpack](https://webpack.js.org/) to bundle the the code before serving it.\n\n\u003e Note: The code uses `es6`, so you have to use [babel](https://babeljs.io/) to convert the code into `es5` before using `webpack`.\n\n#### **from CDN**\n\nInstead of a local installation (and browserification) you may request a remote copy of AvionDB from unpkg CDN.\n\nTo always request the latest version, use the following:\n\n```html\n\u003c!-- loading the minified version --\u003e\n\u003cscript src=\"https://unpkg.com/aviondb/dist/aviondb.min.js\"\u003e\u003c/script\u003e\n```\n\nCDN-based AvionDB provides the `AvionDB` constructor as a method of the global `window` object. Example:\n\n```javascript\n// create an AvionDB instance\nconst aviondb = await AvionDB.init(\"DatabaseName\", ipfs);\n```\n\n**See [examples/index.html](./examples/index.html) to check out a fully functioning example for AvionDB with browser.**\n\n## Usage\n\n**We are upgrading AvionDB to newer versions of `js-ipfs`. For now, please use js-ipfs@0.44.0**\n\n### Example\n\n```javascript\n// Import modules\nimport AvionDB from \"aviondb\";\nimport IPFS from \"ipfs\";\n\nconst runExample = async () =\u003e {\n  const ipfs = await IPFS.create();\n\n  // Creates a db named \"DatabaseName\" in the \".aviondb\" directory in the project root.\n  // If no path option is defined, $HOME/.aviondb is used for the database directory (e.g. \"C:/Users/John/.aviondb\" or \"~/.aviondb\").\n  const aviondb = await AvionDB.init(\"DatabaseName\", ipfs, {\n    path: \"./.aviondb\",\n  });\n\n  // Returns the List of database names\n  await AvionDB.listDatabases();\n  // prints ['DatabaseName']\n\n  // Creates a Collection named \"employees\"\n  const collection = await aviondb.initCollection(\"employees\");\n\n  // Returns the List of collection names\n  await aviondb.listCollections();\n  // prints ['employees']\n\n  // Adding an employee document\n  await collection.insertOne({\n    hourly_pay: \"$15\",\n    name: \"Elon\",\n    ssn: \"562-48-5384\",\n    weekly_hours: 100,\n  });\n\n  // We also support multi-insert using collection.insert()\n  // See https://github.com/dappkit/aviondb/blob/master/API.md\n\n  // Search by a single field Or many!\n  var employee = await collection.findOne({\n    ssn: \"562-48-5384\",\n  });\n\n  // We also support find(), findById()\n  // See https://github.com/dappkit/aviondb/blob/master/API.md\n\n  // Returns the matching document\n  console.log(employee);\n  // Prints the above added JSON document\n\n  // Update a document\n  var updatedEmployee = await collection.update(\n    { ssn: \"562-48-5384\" },\n    { $set: { hourly_pay: \"$100\" } }\n  );\n\n  // We also support updateMany(), findOneAndUpdate()\n  // See https://github.com/dappkit/aviondb/blob/master/API.md\n\n  // Returns the updated document\n  console.log(updatedEmployee);\n  // Prints the updated JSON document\n\n  // await collection.close(); // Collection will be closed.\n  // await aviondb.drop(); // Drops the database\n  // await aviondb.close(); // Closes all collections and binding database.\n  // await ipfs.stop();\n};\n\nrunExample();\n```\n\nSee [FAQs](#how-can-i-use-aviondb-in-my-application) Section for more examples on how to use AvionDB in your project.\n\n## API\n\nSee [API.md](https://github.com/dappkit/aviondb/blob/master/API.md) for the full documentation.\n\n## Development\n\n### Run Tests\n\n```\nnpm test\n```\n\n### Benchmarks\n\nRun Write Benchmark\n\n```\nnpm run benchmarks:write\n```\n\nRun Query Benchmark\n\n```\nnpm run benchmarks:query\n```\n\nRun Update Benchmark\n\n```\nnpm run benchmarks:update\n```\n\nSee [benchmarks/](https://github.com/dappkit/aviondb/tree/master/test/benchmarks) for more info on benchmarks.\n\n## Specs\n\nWe are working on the initial Specs. See [AvionDB Specs doc](https://github.com/dappkit/aviondb-specs/blob/master/README.md)\n\n## Projects using AvionDB\n\n- [nOS Client](https://github.com/nos/client): **nOS** is a blockchain powered virtual operating system that serves as the gateway to Decentralized Applications. The **nOS Client** (Developer MVP Release) allows for the development of Decentralized Applications that interact with Smart Contracts in the back-end.\n\n- [orbitdb-nos-identity-provider](https://github.com/nos/orbitdb-nos-identity-provider/): OrbitDB and AvionDB Identity Provider for nOS Network and other ARK Core-based blockchains.\n\n- [bitsong-media-player](https://github.com/bitsongofficial/bitsong-media-player): **[Private Repo]** BitSong Media Player for BitSong Blockchain, uses AvionDB to store, and share song tracks \u0026 metadata among the browser clients.\n\n- [js-pinza](https://github.com/vaultec81/js-pinza): Pinza is a IPFS pinning system using [orbit-db](https://github.com/orbitdb/orbit-db), and [aviondb](https://github.com/dappkit/aviondb) as a distributed database.\n\n- [Movie-Reviews-CRUD-Application](https://github.com/BCDevs/movies-avionDB): A Kickstarter Application to understand how AvionDB Works by Implementing one.\n\n## Frequently Asked Questions\n\n### Are there implementations in other languages?\n\nWe are working to implement AvionDB for following languages:\n\n- NodeJS \u0026 Browser JS\n- Typescript\n- Golang\n- Rust\n\nThe best place to find out what is out there and what is being actively worked on is likely by asking in the [Discord](https://discord.gg/88YpNuQ).\n\nIf you want or are planning to create an implementation in a language that is not listed here, then feel free to reach us out and discuss about it in the [Discord](https://discord.gg/88YpNuQ).\n\n### Where can I see your Roadmap?\n\nYou can find our Roadmap [here](https://github.com/dappkit/aviondb/issues/10). The features in the Roadmap are taken from 2 separate issues([#7](https://github.com/dappkit/aviondb/issues/7), [#8](https://github.com/dappkit/aviondb/issues/8)) which individually maintain a list of feature proposals related to OrbitDB-specific improvements \u0026 AvionDB-specific improvements respectively.\n\nThe Roadmap is an open discussion, feel free to add your suggestions, comments.\n\n### What mongodb features does aviondb support?\n\nYou can find all the supported MongoDB-like features in our [API docs](https://github.com/dappkit/aviondb/blob/master/API.md).\n\n### How can I use AvionDB in my Application?\n\nYou can see the following examples to get started with AvionDB:\n\n- [**aviondb-p2p-sync**](https://github.com/dappkit/aviondb-p2p-sync)\n\n  A TodoList example using showing how you can sync/replicate AvionDB data across multiple devices. In this example, we synced a todolist from a desktop browser to a mobile browser using a QR Code.\n\n  - Check out the app [here](https://bit.ly/aviondb-p2p-sync)\n  - Check out the code [here](https://github.com/dappkit/aviondb-p2p-sync)\n\n- [**aviondb-firebase**](https://github.com/dappkit/aviondb-firebase)\n\n  An example using Firebase for AvionDB Access Control. In this example, we used Firebase email/password authentication as an Access Control for AvionDB (a distributed, MongoDB-like database). So, if you would try to write to AvionDB without logging in, the database will not allow you to do so internally.\n\n  - Check out the app [here](https://bit.ly/aviondb-firebase)\n  - Check out the code [here](https://github.com/dappkit/aviondb-firebase)\n\n- [**aviondb-onboard**](https://github.com/dappkit/aviondb-onboard)\n\n  An example using Blocknaive's OnBoard.js Auth based Access Controller for AvionDB \u0026 OrbitDB. This allows you to integrate [AvionDB](https://github.com/dappkit/aviondb) with [@metamask_io](https://twitter.com/metamask_io), [@TorusLabs](https://twitter.com/TorusLabs), [@authereum](https://twitter.com/authereum), [@dapper_labs](https://twitter.com/dapper_labs), [@coinbase](https://twitter.com/coinbase), [@TrustWalletApp](https://twitter.com/TrustWalletApp), [@Trezor](https://twitter.com/Trezor), [@Ledger](https://twitter.com/Ledger), [@fortmatic](https://twitter.com/fortmatic), [@portis_io](https://twitter.com/portis_io), [@Squarelink_Inc](https://twitter.com/Squarelink_Inc), [@WalletConnect](https://twitter.com/WalletConnect), [@opera](https://twitter.com/opera), [@ethstatus](https://twitter.com/ethstatus), [@unilogin](https://twitter.com/unilogin), [@imTokenOfficial](https://twitter.com/imTokenOfficial).\n\n  - Check out the app [here](https://bit.ly/aviondb-blocknative)\n  - Check out the code [here](https://github.com/dappkit/aviondb-onboard)\n\n- [**aviondb-ceramic-3id**](https://github.com/dappkit/aviondb-ceramic-3id)\n\n  An example using DID-agnostic [Ceramic 3IDs](https://jwt.io/) based Access Controller for AvionDB \u0026 OrbitDB. You can join the discussion [here](https://github.com/dappkit/aviondb/issues/41).\n  **Coming Soon**\n\n- [**aviondb-jwt**](https://github.com/dappkit/aviondb-jwt)\n\n  An example using [JWT](https://jwt.io/) based Access Controller for AvionDB \u0026 OrbitDB. You can join the discussion [here](https://github.com/dappkit/aviondb/issues/16).\n  **Coming Soon**\n\n- [**aviondb-webauthn**](https://github.com/dappkit/aviondb-webauthn)\n\n  An example using [WebAuthn](https://webauthn.io/) based Access Controller for AvionDB \u0026 OrbitDB. You can join the discussion [here](https://github.com/dappkit/aviondb/issues/18)\n  **Coming Soon**\n\n### Other Questions?\n\nIf you didn't find the answer to your question(s), feel free to reach us out on [Discord](https://discord.gg/88YpNuQ).\n\n## Contributing\n\n**Take a look at our organization-wide [Contributing Guide](https://github.com/dappkit/aviondb/blob/master/CONTRIBUTING.md).**\n\nAs far as code goes, we would be happy to accept PRs! If you want to work on something, it'd be good to talk beforehand to make sure nobody else is working on it. You can reach us [on Discord](https://discord.gg/88YpNuQ), or in the [issues section](https://github.com/dappkit/aviondb/issues).\n\nIf you want to code but don't know where to start, check out the issues labelled [\"help wanted\"](https://github.com/dappkit/aviondb/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22+sort%3Areactions-%2B1-desc), [\"discussion\"](https://github.com/dappkit/aviondb/issues?q=is%3Aopen+is%3Aissue+label%3A%22discussion%22+sort%3Areactions-%2B1-desc).\n\nPlease note that we have a [Code of Conduct](CODE_OF_CONDUCT.md), and that all activity in the [@dappkit](https://github.com/dappkit) organization falls under it. Read it when you get the chance, as being part of this community means that you agree to abide by it. Thanks.\n\n## Sponsors\n\nThe development of AvionDB has been sponsored by:\n\n- [Dappkit](https://dappkit.io)\n\nIf you want to sponsor developers to work on AvionDB, please consider sponsoring using the \"Sponsor\" button on the top of the [AvionDB Github Page](https://github.com/dappkit/aviondb).\n\n## License\n\n[MIT](https://github.com/dappkit/aviondb/blob/master/LICENSE)\n","funding_links":["https://gitcoin.co/grants/633/dappkit-firebase-for-web-30"],"categories":["TypeScript","typescript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faviondb%2Faviondb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faviondb%2Faviondb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faviondb%2Faviondb/lists"}