{"id":19620609,"url":"https://github.com/alwatr/nitrobase","last_synced_at":"2025-04-28T03:32:08.097Z","repository":{"id":40835755,"uuid":"205688039","full_name":"Alwatr/nitrobase","owner":"Alwatr","description":"Nitrobase is a blazingly fast, lightweight database built on JSON. It stores data entirely in memory for lightning-quick access, while also providing a JSON file backup for persistence. You can easily serve your data over the web using our high-performance accelerated Nginx server.","archived":false,"fork":false,"pushed_at":"2025-04-10T00:50:36.000Z","size":4594,"stargazers_count":5,"open_issues_count":5,"forks_count":4,"subscribers_count":3,"default_branch":"next","last_synced_at":"2025-04-17T22:29:42.177Z","etag":null,"topics":["database","db","ecmascript","javascript","json","nodejs","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Alwatr.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-09-01T14:29:07.000Z","updated_at":"2025-03-16T12:36:11.000Z","dependencies_parsed_at":"2023-12-11T02:28:34.901Z","dependency_job_id":"bbb258c8-1c45-4107-8035-3fbd7b81c1c4","html_url":"https://github.com/Alwatr/nitrobase","commit_stats":{"total_commits":1800,"total_committers":16,"mean_commits":112.5,"dds":0.5177777777777778,"last_synced_commit":"2bc7ab8d40ca6b8c90dc3a0d61c8b226024f5fbc"},"previous_names":["alwatr/storage","alwatr/store","alwatr/nitrobase","alimd-hub/nitrobase"],"tags_count":52,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alwatr%2Fnitrobase","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alwatr%2Fnitrobase/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alwatr%2Fnitrobase/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Alwatr%2Fnitrobase/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Alwatr","download_url":"https://codeload.github.com/Alwatr/nitrobase/tar.gz/refs/heads/next","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251246155,"owners_count":21558759,"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","db","ecmascript","javascript","json","nodejs","typescript"],"created_at":"2024-11-11T11:19:24.626Z","updated_at":"2025-04-28T03:32:07.354Z","avatar_url":"https://github.com/Alwatr.png","language":"TypeScript","readme":"# Nitrobase\n\n**Extremely Fast and Compact JSON-Based In-Memory Database with Nginx Integration**\n\nNitrobase is a blazingly fast, lightweight database built on JSON. It stores data entirely in memory for lightning-quick access, while also providing a JSON file backup for persistence. You can easily serve your data over the web using our high-performance accelerated Nginx server.\n\n## Key Features\n\n* **In-Memory Performance:** All data is stored in RAM, ensuring extremely fast reads and writes.\n* **JSON Simplicity:** Data is stored and managed in a straightforward JSON format.\n* **File Backup:** Automatic JSON file backup ensures data persistence.\n* **Nginx Integration:** Seamlessly serve your data over the web using accelerated Nginx.\n* **Compact Storage:** Efficient storage format minimizes disk space usage.\n\n## Installation\n\n```bash\nnpm install @alwatr/nitrobase\n```\n\n## Getting Started\n\n### Create a Collection\n\n```js\nimport { AlwatrNitrobase, Region } from '@alwatr/nitrobase';\n\nconst alwatrStore = new AlwatrNitrobase({\n  rootPath: './db',\n  defaultChangeDebounce: 2_000, \n});\n\nconst postsCollectionId = {\n  name: 'post',\n  region: Region.PerUser,\n  ownerId: 'user_123',\n  schemaVer: 2,\n};\n\nalwatrStore.newCollection(postsCollectionId);\n\nconst postsCollection = await alwatrStore.openCollection(postsCollectionId);\n\npostsCollection.addItem('post1', {\n  title: 'My First Post',\n  content: 'This is the content of my first post.'\n});\n```\n\n### Create a Document\n\n```js\nimport { AlwatrNitrobase, Region } from '@alwatr/nitrobase';\n\nconst alwatrStore = new AlwatrNitrobase({\n  rootPath: './db',\n  defaultChangeDebounce: 2_000, \n});\n\nconst docId = {\n  name: 'posts/my-first-post',\n  region: Region.Authenticated,\n};\n\nalwatrStore.newDocument(docId, {\n  title: 'My First Post',\n  content: 'This is the content of my first post.'\n});\n\nconst myPost = await alwatrStore.openDocument(docId);\n```\n\n## Demo Code\n\nExplore the provided demo code (`collection.mjs`, `document.mjs`, `benchmark.mjs`) to see Alwatr Nitrobase in action and gain a deeper understanding of its capabilities.\n\n## Sponsors\n\nThe following companies, organizations, and individuals support Nitrobase ongoing maintenance and development. Become a Sponsor to get your logo on our README and website.\n\n[![Exir Studio](https://avatars.githubusercontent.com/u/181194967?s=200\u0026v=4)](https://exirstudio.com)\n\n### Contributing\n\nContributions are welcome! Please read our [contribution guidelines](https://github.com/Alwatr/.github/blob/next/CONTRIBUTING.md) before submitting a pull request.\n\n### License\n\nThis project is licensed under the [AGPL-3.0 License](LICENSE).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falwatr%2Fnitrobase","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falwatr%2Fnitrobase","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falwatr%2Fnitrobase/lists"}