{"id":20995112,"url":"https://github.com/blackboxvision/ra-firebase-starter","last_synced_at":"2026-05-08T15:46:27.108Z","repository":{"id":85769426,"uuid":"452453144","full_name":"BlackBoxVision/ra-firebase-starter","owner":"BlackBoxVision","description":"React Admin + Firebase 🔥  = 🎉 🎉","archived":false,"fork":false,"pushed_at":"2024-05-18T13:47:02.000Z","size":593,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-06-04T02:42:46.190Z","etag":null,"topics":["firebase","react","react-admin"],"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/BlackBoxVision.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-01-26T21:54:03.000Z","updated_at":"2024-05-18T13:47:05.000Z","dependencies_parsed_at":null,"dependency_job_id":"bd36cbf6-f908-4b44-a90c-634868219484","html_url":"https://github.com/BlackBoxVision/ra-firebase-starter","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackBoxVision%2Fra-firebase-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackBoxVision%2Fra-firebase-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackBoxVision%2Fra-firebase-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackBoxVision%2Fra-firebase-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BlackBoxVision","download_url":"https://codeload.github.com/BlackBoxVision/ra-firebase-starter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackBoxVision%2Fra-firebase-starter/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259176107,"owners_count":22817118,"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":["firebase","react","react-admin"],"created_at":"2024-11-19T07:21:46.018Z","updated_at":"2026-05-08T15:46:26.789Z","avatar_url":"https://github.com/BlackBoxVision.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🔥 RA Firebase Starter 🔥\n\nAt [**BlackBox Vision**](https://www.blackbox-vision.tech) we use heavily React Admin to build internal systems for our clients.\n\nAlso, we rely on firebase a lot for MVP products. After a lot of work and improvements over time, we've created this starter that includes everything you would need to work with RA and Firebase.\n\n## 📖 Table of contents\n\n- [Requirements](#-requirements)\n- [Getting Started](#-getting-started)\n- [Dependency Management](#-dependency-management)\n- [Project Structure](#-project-structure)\n- [Firebase Setup](#-firebase-setup)\n- [Running the project](#-running-the-project)\n- [Available Scripts](#-available-scripts)\n\n### ✨ Requirements\n\nTo use this template, you need (obviously) to have **Node.js** and **NPM** at least.\n\nIf you don't you can install them by using [**NVM**](https://github.com/nvm-sh/nvm). If you're a windows user you can install them with [**NVM for Windows**](https://github.com/coreybutler/nvm-windows).\n\n### 🪄 Getting Started\n\nTo use this template the only thing you need to do is perform a fork from our repo, or in case you don't want to do that you can download the zip repo's version.\n\n### 💻 Dependency Management\n\nAs you can see, this repository only has a **package-lock.json** which means that NPM is vastly used at **BlackBox Vision** for dependency management in **Node.js**.\n\n\u003e You can feel free to bring your own package manager when using this starter, we don't want to limit any team wanting to use our repo as a baseline for building internal backoffice systems.\n\n### 🏢 Project Structure\n\nStill a WIP 😅, we'll be documenting ASAP our decisions on the project structure architecture.\n\n### 🔨 Firebase Setup\n\nIf you're new to **Firebase**, check out this [video](https://www.youtube.com/watch?v=6juww5Lmvgo) on how to create a Firebase project.\n\n#### 1. Authentication\n\nAll requests must contain a `Bearer Token` to access Firestore data. To enable this, you need to activate [Firebase Authentication](https://console.firebase.google.com/project/ra-firebase-starter/authentication) manually. \n\n1. Go to the \"Sign-In method\" tab.\n2. Choose \"Native Providers\", then select \"Email/Password\".\n3. After that, navigate to the \"Users\" tab.\n4. Create a new admin user with the email \"admin@email.com\", or any other email of your preference.\n   \nThis will allow to log in from the page `/login`.\n\n#### 2. Read/Write data\n\n`Important❗:`\nBefore you can create or read data directly from the database, make sure to activate [Firebase Firestore](https://console.firebase.google.com/project/ra-firebase-starter/firestore) manually from Firebase Console.\n\n\n#### 3. Upload Images\n\n`Important❗:`\nTo enable file uploads for images, you need to activate [Firebase Storage](https://console.firebase.google.com/project/ra-firebase-starter/storage) manually from Firebase Console.\n\n### 🏃‍♂️ Running the project\n\nTo run the project you need to perform the following steps:\n\n1. Install all the project dependencies\n\n```\nnpm i\n```\n\n2. Add an `.env` file like the following one\n\n```bash\nVITE_APP_FIREBASE_APPLICATION_CREDENTIALS=your-firebase-config-object\n```\n\n3. Run the app\n\n```bash\nnpm run dev\n```\n\nWhen finished building your app for development, it'll be available at `http://localhost:5173`.\n\n### 🔋 Available Scripts\n\nSince this project is [**VITE**](https://vitejs.dev/) based, you inherit all commands, that are the following ones:\n\n- **Start**: Start dev server and launch your application.\n\n```bash\nnpm run dev\n```\n\n- **Build**: Build will generate a production build of your app which then can be uploaded to any place where you want it to be hosted and served to end users.\n\n```bash\nnpm run build\n```\n\n- **Preview**: Locally preview production build.\n\n```bash\nnpm run preview\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackboxvision%2Fra-firebase-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblackboxvision%2Fra-firebase-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackboxvision%2Fra-firebase-starter/lists"}