Website Builder

The Website Builder is a powerful capability that enables you to rapidly create and deploy branded websites with minimal configuration. It provides a flexible framework for building customized web experiences that can integrate with your existing systems, while handling common functionality like authentication, navigation, and responsive design.

This solution allows you to focus on your unique content and business requirements instead of developing website infrastructure from scratch. With the Website Builder, you can quickly launch websites that maintain consistent branding, offer user account management, and display dynamic content based on user entitlements.

Getting started

1. Create a new tenant in Dynamics 365

Sign in to Dynamics and create a new tenant

2. Create a new json file and name it using the following convention:

{sanitisedDomainName}.json
where sanitisedDomainName is the domain name of your new tenant and then replacing any : characters with a . (See examples)

Examples

Domain name	sanitisedDomainName	File name
new.tenant.platform.lightstone.co.za	new.tenant.platform.lightstone.co.za	new.tenant.platform.lightstone.co.za.json
localhost:4200	localhost.4200	localhost.4200.json

3. Copy the below into the file:

{
  "name": "{TENANT_NAME}",
  "http": {
    "headers": {
      "Ocp-Apim-Subscription-Key": "{AUTHENTICATED_APP_API_KEY}"
    }
  },
  "onboarding": {
    "baseUrl": "https://onboard.platform.coaxle.co.za/",
    "queryString": {
      "tenant-id": "{TENANT_ID}"
    }
  },
  "styling": {
    "logoUrl": "./assets/LightstoneLogo.png",
    "cssUrl": "https://cdn.toolkit.lightstone.co.za/Lightstone.Design/v5/css/lightstone.css"
  },
  "layout": {
    "topbar": {},
    "pages": [
      {
        "name": "Home",
        "path": "home",
        "navigation": {
          "name": "Home",
          "display": "name",
          "icon": "fa-home"
        },
        "components": [
          {
            "name": "landing",
            "html": "<section class='pt-5 pb-5 mt-0 align-items-center d-flex bg-dark' style='height:100vh; background-size: cover; background-image: url(https://images.unsplash.com/photo-1525130413817-d45c1d127c42?ixlib=rb-0.3.5&s=c3d0603820b595592d80f5a239938c67&auto=format&fit=crop&w=1500&q=80);'>              <div class='container-fluid'>               <div class='row  justify-content-center align-items-center d-flex text-center h-100'>                 <div class='col-12 col-md-8  h-50 '>                     <h1 class='text-white'>Hello world!</h1></p></div>                             </div>             </div>             </section>"
          }
        ]
      }
    ]
  }
}

Replace the following placeholders in your configuration file:

Placeholder	Description	Example
TENANT_NAME	The name of your tenant that will appear in the browser title and throughout the application	"Company Portal"
AUTHENTICATED_APP_API_KEY	The API key for accessing tenant resources - must be generated as an Authenticated Application Key in your Dynamics tenant settings	"a1b2c3d4-5e6f-7g8h-9i0j-k1l2m3n4o5p6"
TENANT_ID	The unique Reference ID of your Dynamics tenant (found in Tenant Settings > Properties)	"TNT_12345"

4. Upload the configuration file

To deploy your configuration:

1. Access the website's hosting environment where the Website Builder is deployed
2. Navigate to the /config directory in the root of your site
3. Upload your JSON file using one of these methods:
   • SFTP client if you have server access
   • Content Management System interface
   • Deployment pipeline (if configured with CI/CD)
4. Verify the file uploaded successfully by checking file permissions (should be 644)

Once uploaded, the Website Builder will automatically detect your configuration on the next page load.