Step 1: Set Up Parent Account

book
Note
This section assumes you will be testing website deployment across sub-accounts in a test reseller account provisioned to you by Yext. Please each out to your account team if you would like a test account provisioned to you.

The video below walks through the instructions for this step.

In this section, you will be populating your parent account with test data, developing a website locally on your computer, and deploying your code to production.

Log into your account and click on “Your Dashboard” in the top-right corner. From your dashboard you can see the full Yext platform with all available products listed in the left-hand navigation menu, including Knowledge Graph and Pages.

Now that you have familiarized yourself with your parent account, let’s get started with website development.

Pages Local Development

  1. To get started with Pages local development, open up your terminal and run the following command. This will establish a connection to your Yext account.

    yext init REPLACE_ME_ACCOUNT_ID
    book
    Note
    You can find your account ID in the URL of your Yext account /s/[[account ID]]/.... account ID url
  2. Next, run the following command:

    yext pages new

    From the prompts, select the following:

    1. Create a new repo or link an existing GitHub repo? Create a new repo
    2. Which starter repository? Fleet SMB Starter
    3. What would you like to call it? fleet-smb-starter
    4. Would you like to setup a remote GitHub repository? Yes
    5. Would you like to install dependencies? Yes
    6. Would you like to populate your account with seed data? Yes
      • This will add test data to the Knowledge Graph in your parent account, which will be used to power your site.
  3. Run the following commands to begin local development!

    cd fleet-smb-starter
    npm run dev
  4. (Optional) Briefly familiarize yourself with the repo by examining the src/templates folder; each of these templates corresponds to a page (or set of pages) in your site (refer to our Templates reference doc for more information).

Deploy to Production

Once you’ve verified your site looks good, you can deploy it to production by following the Initial Deploy training unit.