Hosting

How to add your custom domain using Bullet.so?

1. Click on “Site Setting” and navigate to the domains section, and click on “Add Custom Domain”.

2. Next, in the pop-up that opens, enter the domain you want to connect to.

3. Now, copy & paste the CNAME records into your DNS settings by following the instructions provided. You will find the option to configure this in your domain registrar settings.

4. Once you add the CNAME records, click on the “verify” button to verify if the records are configured properly.

Legacy User

1. Click on “Settings” and navigate to the domains section, and click on “Add Custom Domain”.

Hosting in Root or Apex domain

How to host your bullet site on your root or apex domain.

1. Check if you are able to set ALIAS or ANAME record and configure the “ @, root or host” to your site.pages.dev domain.

2. If there is no ALIAS or ANAME record, simply add the CNAME record and point root to your -bullet.pages.dev domain and check if everything is working fine.

What if your DNS provider doesn't support ALIAS, ANAME or CNAME Flattening?

1. Easiest way: Point the www.example.com instead of apex domain. Most modern browsers don't display the www. in the address bar, and it would look very similar to apex domain.

2. The other way is to point your domain nameservers (NS records) to a third-party DNS provider like Cloudflare and manage your DNS records there. Cloudflare is free to use and offers additional benefits beyond DNS services.

How to host your Bullet site as a subdirectory?

Step 1: Configuring your Sub-Directory

• Navigate to the domains section and click on the “Sub-Directory”.

• Next, enter the domain name and the sub-directory (Hosting path) details for your site.

Step 2: Setting up a reverse proxy

• Create a new Cloudflare worker, and add the below code.

• Now, In the 3rd line in the code add the current URL of your bullet site. You will find in your Site settings in your bullet dashboard.

• Next, In the 4th line of the code add the subrirectory(Hosting path) details you added in the Bullet dashboard.

addEventListener('fetch', (event) => {

    // Add your bullet subdomain below. Avoid trailing slash

    const bulletUrl = new URL(`https://your-url-bullet.pages.dev`)

    // Add sub-directory path where you want to see your bullet site in the next line. Avoid trailing slash/

    const subdirectory = "/blog"

    const requestUrl = new URL(event.request.url)

    const pathname = requestUrl.pathname

    if (pathname.startsWith(`${subdirectory}/`) || pathname === subdirectory) {

        event.passThroughOnException()

        event.respondWith(fetch(`${bulletUrl.origin}${pathname.replace(subdirectory, "")}${requestUrl.search}`, event.request).then((response) => {

            const clonedResponse = new Response(response.body, response);

            if (clonedResponse.status === 308) {

                const redirectLocation = clonedResponse.headers.get("location");

                const destination = (subdirectory + redirectLocation + "/").replace('//', '/');

                redirectLocation && clonedResponse.headers.set("location", destination);

            }

            return clonedResponse;

        }))

    } else {

        event.respondWith(fetch(event.request))

    }

})

• After creating the worker and deploying, add the Worker Route, and set the path to https://example.com/blog\*

• Add the below snippet in your nginx configuration(.conf) file.

• Update and replace your placeholder proxy\_pass details with your bullet domain.

location /blog/ {

proxy_pass https://{{bullet-subdomain}}-bullet.pages.dev/;

proxy_ssl_server_name on;

}

• Add the Below Code in your next.config.js file.

• Replace the placeholder data in the code below with appropriate details.

// next.config.js

/** @type {import('next').NextConfig} */

const config = {

    rewrites() {

        const bulletUrl = new URL(

            `https://{{bullet-subdomain}}-bullet.pages.dev`,

        ).origin

        return [\\

            {\\

                source: '/blog',\\

                destination: `${bulletUrl}`,\\

            },// match all paths with extension eg .xml, .json etc.\\

            {\\

                source: '/blog/:slug(.*\\\\.[a-zA-Z]{2,5}$)',\\

                destination: `${bulletUrl}/:slug`,\\

            },// match all paths starting with /blog\\

            {\\

                source: '/blog/:path*',\\

                destination: `${bulletUrl}/:path*/`,\\

            },\\

        ]

    },

}

module.exports = config

trailingSlash: true

Adding redirects for your website links

1. Click on “Site Settings” in the site dashboard

2. Navigate to the “Domain” section.

3. Scroll down to the redirects section and fill in your old and new URL details

4. Next, click on the “Add Redirect” button and click Save.

Understanding the redirect types, rules, and formats:

Redirect Types

1. Static Redirect: A simple URL-to-URL redirect without any dynamic values.

2. Dynamic Redirects: A complex URL where you can use dynamic values instead of adding 10s or 100s of static redirects.

Supported redirect formats

Rules:

1. If there are multiple redirects for the same source path, the top-most redirect is applied.

2. Redirects happen before headers, so if a request matches rules in both files, the redirect will win out

3. Static redirects need to be added first, and then the dynamic redirects.

4. A project can have a maximum of 2,000 static redirects and 100 dynamic redirects for a total of 2,100 redirects.

5. Each redirect declaration has a 1,000-character limit.

Splats

Placeholder

• The colon indicates the start of a placeholder, and the name that follows may be composed of alphanumeric characters and underscores, :\w+.

• A placeholder with a given name can only be used once in the URL. Placeholders match all characters apart from the delimiter, which: when part of the host, is a period or a forward-slash; and when part of the path, is a forward-slash.

• The matched value can similarly be used in the redirect location with :placeholder_name. By doing this, it allows for greater flexibility and usability for both users and developers.

Unsupported Redirects

1. Click on “Settings” of your website in the Bullet dashboard and navigate to the “Redirects” section.

2. Scroll down to the redirects section and fill in your old and new URL details

3. Next, click on the “Add Redirect” button and click Save.

How to Configure Both Apex Domain and www, So Your Site Works in Both

How to Set Up Domain Redirects

Cloudflare

Namecheap

GoDaddy

Restrict Your Site to a Custom Domain Only

Add the Redirect Script

<script>

  (function() {

    const currentHost = window.location.hostname;

    // Specify your custom domain here

    const customDomain = "yourcustomdomain.com";

    // Check if the current host includes "-bullet.pages.dev" or ".bullet.site"

    if (currentHost.includes("-bullet.pages.dev") || currentHost.includes(".bullet.site")) {

      // Redirect to the custom domain while preserving the path and query parameters

      const newUrl = window.location.href.replace(currentHost, customDomain);

      window.location.replace(newUrl);

    }

  })();

</script>

For sub-directory sites