{"id":20011384,"url":"https://github.com/jorgeandrespadilla/firestore-db-manager","last_synced_at":"2025-03-02T02:16:59.089Z","repository":{"id":57152842,"uuid":"394127777","full_name":"jorgeandrespadilla/firestore-db-manager","owner":"jorgeandrespadilla","description":"Firestore Database Manager is a CLI tool that enables generating backups, restoring backups and deleting any database created with Cloud Firestore.","archived":false,"fork":false,"pushed_at":"2021-08-09T18:57:53.000Z","size":152,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-12T23:14:13.100Z","etag":null,"topics":["backup","firebase","firestore","typescript"],"latest_commit_sha":null,"homepage":"","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/jorgeandrespadilla.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-08-09T02:54:10.000Z","updated_at":"2022-11-21T16:58:59.000Z","dependencies_parsed_at":"2022-09-06T07:00:58.229Z","dependency_job_id":null,"html_url":"https://github.com/jorgeandrespadilla/firestore-db-manager","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jorgeandrespadilla%2Ffirestore-db-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jorgeandrespadilla%2Ffirestore-db-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jorgeandrespadilla%2Ffirestore-db-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jorgeandrespadilla%2Ffirestore-db-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jorgeandrespadilla","download_url":"https://codeload.github.com/jorgeandrespadilla/firestore-db-manager/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241447645,"owners_count":19964336,"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":["backup","firebase","firestore","typescript"],"created_at":"2024-11-13T07:25:44.082Z","updated_at":"2025-03-02T02:16:59.059Z","avatar_url":"https://github.com/jorgeandrespadilla.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Firestore Database Manager\n\n[![](https://img.shields.io/npm/l/firestore-db-manager.svg)](https://github.com/andreasonny83/firestore-db-manager/blob/master/LICENSE)\n[![](https://img.shields.io/npm/v/firestore-db-manager.svg)](https://npmjs.org/package/firestore-db-manager)\n\nFirestore Database Manager (`firestore-db`) is a CLI tool that enables generating backups, restoring backups and deleting any database created with [Cloud Firestore](https://firebase.google.com/docs/firestore).\n\n## Installation\n\nInstall with [npm](https://www.npmjs.com/package/firestore-db-manager).\n````\nnpm i -g firestore-db-manager\n````\n\nInstall with [yarn](https://yarnpkg.com/package/firestore-db-manager).\n````\nyarn global add firestore-db-manager\n````\n\nThis will install `firestore-db` globally so that it may be run from the command line anywhere.\n\n## Usage\n\nBefore executing this command, you must download the Firestore database key file from your project service account configurations:\nhttps://console.firebase.google.com/u/0/project/your_database_id/settings/serviceaccounts/adminsdk\n\nAfter downloading the corresponding JSON file, you can proceed to execute the command in the same path where you locally saved the project key.\n````\nfirestore-db [options]\n````\n\n## Configurations\n\nAn additional JSON file can be created to specify general configurations to the Firestore Database Manager.\n\nThis file must be located in the same path where the key file aws stored. It should also be named `backup-config.json` and have the following structure:\n````JSON\n{\n    \"backupFile\": \"...\",\n    \"keyFile\": \"...\",\n    \"databaseURL\": \"...\"\n}\n````\nParameters      | Description\n---             |---\n`backupFile`    | Source/Destination JSON backup file (defaults to `backup.json`)\n`keyFile`       | Firestore service account JSON key file (defaults to `key.json`)\n`databaseURL`   | Project database URL (defaults to `https://\u003cyour_database_id\u003e.firebaseio.com`)\n\n**Note:** All these parameters are optional and are automatically generated if some of them are missing, or when a configuration file was not found at the current path.\n## Available options\n\nFlags                       | Description\n---                         |--- \n`-i`, `--init-config`       | Create a default backup configuration file ('backup-config.json')\n`-g`, `--generate-backup`   | Generate a backup of a Firestore database\n`-r`, `--restore-backup`    | Restore a backup of a Firestore database\n`-d`, `--restore-backup`    | Delete a Firestore database\n`-h`, `--help`              | Show available options\n`-v`, `--restore-backup`    | Show current version number\n\n**Note:** Only one option can be specified per execution.\n\n# License\n\n[MIT License](https://andreasonny.mit-license.org/2018) © Jorge Andrés Padilla","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjorgeandrespadilla%2Ffirestore-db-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjorgeandrespadilla%2Ffirestore-db-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjorgeandrespadilla%2Ffirestore-db-manager/lists"}