AgileX Internal Portal — Google Sites Guide

How to create an internal explainer portal for your Google Workspace team

1 What You'll Get

A Google Sites portal that your entire agilex.co.za workspace team can access — no login needed beyond their Google account. It links to all the guides and live tools in one internal hub.

sites.google.com/agilex.co.za/recruitment-platform
Home
Architecture
Training
Agents
Deployment
Links

AgileX A.G.I.L.E. Recruitment Platform

AI-powered recruitment intelligence — your agents recruit, your team decides

Live Demo

Interactive agent portal on Cloudflare

Huly ATS

Recruitment pipeline & candidates

Architecture

How all the layers connect

Training

Role-based user guides

Deployment

Setup steps & timeline

M365 Integration

OneDrive, SharePoint, Teams

2 Create the Google Site

1

Go to Google Sites

Open sites.google.com and click the + Blank button to create a new site.

2

Name it

Title: AgileX Recruitment Platform
URL slug: recruitment-platform (set under the publish dialog later)

3

Set up the navigation pages

In the right sidebar click Pages+ to add these pages:

Page NameContent
HomeHero banner + quick links to all sections
ArchitectureEmbed the architecture guide
TrainingEmbed the training guide
A.G.I.L.E. AgentsEmbed the sales demo portal
DeploymentEmbed the deployment guide
Quick LinksTable of all URLs, logins, repo links
4

Publish — internal only

Click Publish → under Who can see my site, select Everyone at agilex.co.za (or specific people). This restricts access to your Google Workspace domain.

3 Page-by-Page Content

For each page, you can either embed the HTML guides (via iframe from Pages.dev) or add content natively in Google Sites. Below is the recommended approach for each page.

Home Page

Layout

  1. Hero section — Insert → Banner. Title: "AgileX A.G.I.L.E. Recruitment Platform". Subtitle: "AI-powered recruitment intelligence — your agents recruit, your team decides"
  2. 6 card grid — Insert → Button (×6), linking to each sub-page. Use icons or emoji for each:
    • Live Demo → links to Pages.dev or agilex-app.pages.dev
    • Huly ATS → links to localhost:8087 or huly.agilex.co.za
    • Architecture → links to Architecture page
    • Training → links to Training page
    • Deployment → links to Deployment page
    • Git Repo → links to github.com/2nth-ai/agilex-portal
  3. Status summary — Insert → Text box. Paste the current status:
Current Status (2026-04-11):
- Huly ATS: Running locally on Docker (14 containers)
- Portal: Deployed to Cloudflare (agilex-app.pages.dev)
- Edge AI: Tested — Llama 3.1 8B parsing CVs at the edge
- Git: github.com/2nth-ai/agilex-portal (4 commits)
- Staff: 11 accounts, 10 clients, 15 vacancies, 30 candidates
- Next: Add DNS record to activate agilex-app.pages.dev

Architecture Page

Option A: Embed (recommended)

Insert → Embed → By URL → paste:

https://agilex-app.pages.dev/setup.html

Set the embed to full width and adjust height to ~800px.

Option B: Native content

Copy the architecture diagram and key tables from the guide into Google Sites text blocks. Use Insert → Collapsible text for the detailed sections.

Training Page

Embed the training guide

Insert → Embed → By URL:

https://agilex-app.pages.dev/setup.html

Or upload training-guide.html to Google Drive and embed from there. For the training guide specifically, you may want to create native Google Sites content so staff can comment on sections.

A.G.I.L.E. Agents Page

Embed the interactive demo

This is the best page to embed — the interactive demo with animated agent chat works great in an iframe.

<!-- If using full-page embed via Google Sites -->
Insert → Embed → By URL:
https://agilex-app.pages.dev

<!-- Once DNS is active, use the full Worker URL instead: -->
https://agilex-app.pages.dev

Set to full width, height ~700px.

Deployment Page

Embed or link the deployment guide

https://agilex-app.pages.dev/dns-guide.html

Also add a native text block with the 4-week timeline and current status checkmarks.

Quick Links Page

Build natively in Google Sites

Insert → Table. Create a reference table with all URLs, credentials, and repo links. This page should be native (not embedded) so it's easy to update.

4 How to Embed HTML Pages in Google Sites

Method 1: Embed by URL (easiest)

  1. In the Google Sites editor, click Insert (right sidebar)
  2. Click Embed
  3. Select the By URL tab
  4. Paste the Pages.dev URL (e.g. https://agilex-app.pages.dev/setup.html)
  5. Click Insert
  6. Resize the embed to full width and set height to 700–900px

Note: The source must allow embedding. Cloudflare Pages allows this by default. If you get a blocked error, you may need to add X-Frame-Options headers — see Method 2.

Method 2: Embed from Google Drive

  1. Upload your HTML file to Google Drive
  2. Right-click → Open withGoogle Docs (or just get the file ID)
  3. The Drive preview URL is: https://drive.google.com/file/d/FILE_ID/preview
  4. In Google Sites: Insert → Embed → By URL → paste the preview URL

Drive-hosted HTML renders in a sandboxed viewer. Styling may differ slightly. For best results, use Method 1 or Method 3.

Method 3: Embed with custom HTML

  1. In Google Sites: Insert → Embed → Embed code tab
  2. Paste an iframe tag:
<iframe
  src="https://agilex-app.pages.dev/setup.html"
  width="100%"
  height="800"
  style="border: none; border-radius: 8px;"
></iframe>

This gives the most control over sizing and is the recommended approach for the interactive demo portal.

Embeddable URLs — Ready to Use

PageEmbed URLRecommended Height
Interactive Demohttps://agilex-app.pages.dev700px
Architecture + Setuphttps://agilex-app.pages.dev/setup.html900px
DNS & Statushttps://agilex-app.pages.dev/dns-guide.html800px

5 Upload All Guides to Google Drive

For offline access and as a backup, upload all HTML guides to a shared Google Drive folder:

Create a shared folder

  1. Google Drive → NewFolder → name it AgileX Platform Guides
  2. Right-click → Share → set to Anyone at agilex.co.za with the link can view
  3. Upload these files from /Users/craig/Projects/AgileX/huly-selfhost/demo/:
FileDescription
index.htmlInteractive sales demo (A.G.I.L.E. agents, role dashboards, pipeline)
architecture.html5-layer visual architecture, AI model routing, M365 structure
setup.htmlPortal setup — project structure, API reference, Edge AI explainer
dns-guide.htmlDNS setup steps, deployment status, test sequence
deployment-guide.htmlMaster deployment guide — everything built, timeline, file map
google-sites-content.htmlThis guide

Also upload from /Users/craig/Projects/AgileX/huly-selfhost/:

guide.htmlHuly ATS setup guide (accounts, workspace, seed data)
training-guide.htmlATS training (roles, candidate data, pipeline stages, daily workflows)

Quick upload command

# Open the demo folder in Finder — drag all HTML files to Google Drive
open /Users/craig/Projects/AgileX/huly-selfhost/demo/

# Or use gdrive CLI if installed:
gdrive upload --parent "FOLDER_ID" \
  demo/index.html \
  demo/architecture.html \
  demo/setup.html \
  demo/dns-guide.html \
  demo/deployment-guide.html \
  demo/google-sites-content.html \
  guide.html \
  training-guide.html

6 Recommended Site Structure

PageContent TypeSource
HomeNative Google SitesHero banner, 6 quick-link buttons, status summary
ArchitectureEmbed (iframe)agilex-app.pages.dev/setup.html — 900px
TrainingNative or Embedtraining-guide.html — roles, pipeline, workflows
A.G.I.L.E. AgentsEmbed (iframe)agilex-app.pages.dev — 700px (interactive demo)
DeploymentEmbed (iframe)agilex-app.pages.dev/dns-guide.html — 800px
Quick LinksNative Google SitesURL table, credentials, repo link (easy to update)

Quick Links page content

Copy-paste this into a Google Sites text block or table:

Live URLs
Portal (static):     https://agilex-app.pages.dev
Setup guide:         https://agilex-app.pages.dev/setup.html
DNS guide:           https://agilex-app.pages.dev/dns-guide.html
Full portal + API:   https://agilex-app.pages.dev (needs DNS record)

Local Development
Huly ATS:            http://localhost:8087
Portal dev server:   http://localhost:8788

Credentials
Huly admin:          admin@agilex.co.za / AgileX2024!
Huly staff:          firstname.lastname@agilex.co.za / AgileX2024!

Code
Git repo:            https://github.com/2nth-ai/agilex-portal (private)
Huly selfhost:       /Users/craig/Projects/AgileX/huly-selfhost/
Portal source:       /Users/craig/Projects/AgileX/agilex-portal/

Cloudflare
Worker:              agilex-portal (agilex-app.pages.dev route)
D1 Database:         agilex-portal (WEUR)
KV Namespace:        CACHE
Pages project:       agilex-demo (agilex-app.pages.dev)
DNS needed:          AAAA → agilex → 100:: (proxied) on 2nth.ai zone

7 Publish & Share

1

Preview

Click the eye icon in the top toolbar to preview the site. Check all embeds load and navigation works.

2

Publish

Click Publish → set the web address to recruitment-platform.

Your site URL will be: https://sites.google.com/agilex.co.za/recruitment-platform

3

Set access to internal only

Under Who can see my site:

  • Select Everyone at agilex.co.za for the whole team
  • Or select Specific people and add individual emails

Anyone outside the workspace will see a "You need permission" page.

4

Share with the team

Send the link via email, Google Chat, or pin it in a Google Space:

https://sites.google.com/agilex.co.za/recruitment-platform

Done — Internal Portal Live

Your team can now access the complete AgileX recruitment platform documentation, interactive demos, and live tools from a single Google Sites hub — restricted to your workspace domain, no external access, automatically authenticated via Google Workspace SSO.