firebase.md - is-a-dev-docs - is-a.dev Documentation

firebase.md (2122B)
      1 ---
      2 order: 1350
      3 icon: /media/firebase.svg
      4 label: Firebase
      5 tags: guides
      6 ---
      7 
      8 # Setting up Firebase Hosting with an is-a.dev Subdomain
      9 
     10 This guide will walk you through the process of setting up a Firebase Hosting site and pointing your is-a.dev subdomain towards it.
     11 
     12 ## Creating a Firebase Project
     13 
     14 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).
     15 
     16 ### Setting up Firebase Hosting
     17 
     18 1. Install the Firebase CLI: `npm install -g firebase-tools`
     19 2. Initialize Firebase in your project directory: `firebase init hosting`
     20 3. Deploy your site: `firebase deploy`
     21 
     22 ### Creating the Domain File
     23 
     24 Create a JSON file inside the `domains` directory (`domains/subdomain.json`) with the following content and submit a pull request:
     25 
     26 ```json
     27 {
     28   "owner": {
     29     "username": "github-username"
     30   },
     31   "records": {
     32     "CNAME": "your-firebase-site.web.app"
     33   }
     34 }
     35 ```
     36 
     37 Make sure to replace:
     38 
     39 - `github-username` with your actual GitHub username
     40 - `your-firebase-site.web.app` with your hosting site
     41 
     42 ### Configuring Firebase Hosting for Custom Domain
     43 
     44 After your pull request is merged and your is-a.dev subdomain is active:
     45 
     46 1. Go to your Firebase Console
     47 2. Navigate to **Hosting** in the left sidebar
     48 3. Click **Add custom domain**
     49 4. Enter your is-a.dev subdomain (e.g., `example.is-a.dev`)
     50 5. Firebase will verify domain ownership automatically through DNS
     51 6. Wait for the SSL certificate to be provisioned (this can take up to 24 hours)
     52 
     53 ## Notes
     54 
     55 - Firebase Hosting automatically provides SSL certificates for custom domains
     56 - Make sure your Firebase project is deployed and accessible before adding the custom domain
     57 
     58 ## Troubleshooting
     59 
     60 If you encounter issues:
     61 
     62 - Ensure your Firebase project is deployed and accessible via the default `.web.app` domain
     63 - Check that your DNS records have propagated (this can take up to 48 hours)
     64 - Verify your Firebase Hosting configuration in `firebase.json`
     65 - Make sure your build files are in the correct public directory specified in your Firebase configuration