Merge pull request #102 from MarkCay/main

Add Firebase setup guide and SVG icon

Author: iostpa

src/guides/firebase.md

@@ -0,0 +1,67 @@
+---
+order: 1350
+icon: /media/firebase.svg
+label: Firebase
+tags: guides
+---
+
+# Setting up Firebase Hosting with an is-a.dev Subdomain
+
+This guide will walk you through the process of setting up a Firebase Hosting site and pointing your is-a.dev subdomain towards it.
+
+## Creating a Firebase Project
+
+First, create a Firebase project and set up Firebase Hosting. Follow the instructions in the [Firebase Hosting Documentation](https://firebase.google.com/docs/hosting/quickstart).
+
+### Setting up Firebase Hosting
+
+1. Install the Firebase CLI: `npm install -g firebase-tools`
+2. Initialize Firebase in your project directory: `firebase init hosting`
+3. Deploy your site: `firebase deploy`
+
+### Creating the Domain File
+
+Create a JSON file inside the `domains` directory (`domains/subdomain.json`) with the following content and submit a pull request:
+
+```json
+{
+  "owner": {
+    "username": "github-username",
+    "email": "[email protected]"
+  },
+  "records": {
+    "CNAME": "your-firebase-site.web.app"
+  }
+}
+```
+
+Make sure to replace:
+
+- `github-username` with your actual GitHub username
+- `[email protected]` with your email address
+- `your-firebase-site.web.app` with your hosting site
+
+### Configuring Firebase Hosting for Custom Domain
+
+After your pull request is merged and your is-a.dev subdomain is active:
+
+1. Go to your Firebase Console
+2. Navigate to **Hosting** in the left sidebar
+3. Click **Add custom domain**
+4. Enter your is-a.dev subdomain (e.g., `example.is-a.dev`)
+5. Firebase will verify domain ownership automatically through DNS
+6. Wait for the SSL certificate to be provisioned (this can take up to 24 hours)
+
+## Notes
+
+- Firebase Hosting automatically provides SSL certificates for custom domains
+- Make sure your Firebase project is deployed and accessible before adding the custom domain
+
+## Troubleshooting
+
+If you encounter issues:
+
+- Ensure your Firebase project is deployed and accessible via the default `.web.app` domain
+- Check that your DNS records have propagated (this can take up to 48 hours)
+- Verify your Firebase Hosting configuration in `firebase.json`
+- Make sure your build files are in the correct public directory specified in your Firebase configuration