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

netlify.md (2033B)
      1 ---
      2 order: 1600
      3 icon: /media/netlify.svg
      4 label: Netlify
      5 tags: guides
      6 ---
      7 
      8 # Setting up Netlify with an is-a.dev Subdomain
      9 
     10 This guide will walk you through the process of setting up a Netlify deployment and pointing your is-a.dev subdomain towards it.
     11 
     12 ## Creating a Netlify Website
     13 
     14 First, create a website on Netlify. Follow the instructions in the [Netlify Docs](https://docs.netlify.com/).
     15 
     16 ## Adding the domain to Netlify
     17 
     18 To get the records for Netlify, navigate to **Site Settings > Domain Management > Custom Domains** and add `subdomain.is-a.dev` (as an example, you should add the domain which you want to register) in the given field.
     19 
     20 ### Creating the Domain File
     21 
     22 You should see two domains that Netlify added, `subdomain.is-a.dev` and `www.subdomain.is-a.dev`. You have to make both of them so that you can successfully add a domain to Netlify. (`subdomain` being your domain name of choice, of course)
     23 
     24 Create a JSON file inside the `domains` directory called `subdomain.json` with the following content:
     25 
     26 ```json
     27 {
     28     "owner": {
     29         "username": "github-username"
     30     },
     31     "records": {
     32         "A": ["75.2.60.5"]
     33     }
     34 }
     35 ```
     36 !!!
     37 Note: Don't forget to provide a preview of your website in your pull request.
     38 !!!
     39 
     40 After that, create another JSON file in the same directory called `www.subdomain.json` with the following content:
     41 ```json
     42 {
     43     "owner": {
     44         "username": "github-username"
     45     },
     46     "records": {
     47         "CNAME": "website.netlify.app"
     48     }
     49 }
     50 ```
     51 !!!
     52 Note: The CNAME record should be what Netlify gave you, which should be most of the time the website's domain which Netlify generated, like `website.netlify.app`.
     53 !!!
     54 
     55 After you've made both of the files, make a pull request and wait.
     56 
     57 ## Configuring Netlify
     58 - After your pull request is merged, you should be able to connect the domain with Netlify.
     59 
     60 ### Final Steps
     61 - Wait for the DNS changes to propagate. This can take from a few minutes to a couple of hours.
     62 - Your Netlify website should now be accessible at `your-subdomain.is-a.dev`.