CLAUDE.md — Linc-Website

This repo is the source for linc.co.za, the corporate website of Linc Communications (Pty) Ltd — a South African, award-winning Microsoft Partner specialising in the implementation and support of Microsoft Dynamics 365 Business Central. It is a Jekyll static site served via GitHub Pages on the apex domain linc.co.za (see CNAME). Most content is hand-authored HTML pages (one per Business Central extension app, integration, or topic), styled with Bulma, not a data-driven CMS.

Stack

  • Jekyll via the github-pages gem (see gemfile / Gemfile.lock). Local serving uses webrick.
  • GitHub Pages deployment: pushing to the default branch builds and publishes to linc.co.za. _site/ is the local build output (gitignored as linc.co.za_site plus .jekyll-cache, .sass-cache, vendor).
  • just-the-docs theme is listed in gemfile and _config.yml but the remote_theme line is commented out (“SSL issues with local development”). Real page styling comes from Bulma (CDN, [email protected]) plus inline CSS and the Poppins Google Font, all loaded in _includes/linc_head.html. just-the-docs is essentially vestigial for content pages; the wide.html layout still references its head.html/table_wrappers.
  • Icons via ion-icon web components.

Layout of the repo

  • Content pages live at the repo root as individual files:
    • .html pages for products/integrations/topics (e.g. advanced-logistics.html, commerce7-integration.html, customer-portal.html, extensions.html).
    • .md pages rendered by Jekyll for long-form / legal / audit docs (audit-questions.md, privacy-policy.md, linc-extensions-eula.md, support-escalation.md, schedule-of-costs.md). The published HTML (e.g. audit-questions.html) is built from the markdown — edit the .md, not the built output.
    • index.html is the homepage.
  • _layouts/ — template_home.html (homepage), template_page.html (standard content page), template_boltrics.html, wide.html.
  • _includes/ — shared partials: linc_head.html (the <head>: analytics, Bulma, fonts, and all inline CSS), linc_footer.html, linc_scripts.html, header variants (linc_header_home.html, linc_header_page.html, linc_header_boltrics.html), menu.html, and forms (linc_contact_form.html, linc_appsource_form.html).
  • assets/ — images/ (incl. logos), files/ (downloads), js/.
  • search-data.json — generates a client-side search index over pages (curiously filters to nav_exclude == true pages).
  • backup/, old_extensions.backup, tickets.md — legacy/scratch, ignore unless asked.

Page conventions

  • Every content page starts with Jekyll front matter: layout: (usually template_page, template_home for the homepage), title:, and typically nav_exclude: true. The homepage also sets custom_menu: "menu.html".
  • Keep new pages consistent with an existing sibling: copy the front matter and Bulma structure (section / container / has-text-centered, .line, .title, .subtitle, .panel, .button) from a comparable page rather than inventing new markup.
  • Global styles are centralised in the inline <style> block in _includes/linc_head.html — put shared style changes there, not per-page.

Brand palette (design bible — the Linc logo defines it)

Use only the canonical linc.co.za cyans; do not borrow colours from the sub-brands.

  • Primary cyan #009bc2
  • Logo highlight #00aeef
  • Deep cyan #067b9e
  • Muted steel-cyan #69b0c6
  • Gold #c49a6c — a hairline accent only, matching its restrained role in the logo.

Brand feel target: enterprise-trustworthy / Microsoft-aligned. Buttons and the .line accent use a #009bc2 → #69b0c6 gradient. Links are #009bc2.

Domain context

  • Product: Microsoft Dynamics 365 Business Central. Positioning is SaaS-first — the vast majority of clients run on Microsoft’s Business Central cloud (SaaS); only a small handful are on privately hosted / on-premises infrastructure. Linc no longer offers its own hosted environment. Use “Entra ID (Microsoft 365)” terminology, not the older “Azure AD” / “Office365”.
  • The site catalogues Linc’s own Business Central extension apps and third-party integrations (Commerce7, Lightspeed, MarketMan, Micros, WooCommerce, Sage 300 Payroll, TabletPOS, Benson, Boltrics, etc.).
  • Sub-brands / vertical products: ProduceLinc, WineLinc, CommLinc, FarmLinc. Each has its own separate repo (Linc-ProduceLinc-Website, Linc-WineLinc-Website, Linc-CommLinc-Website, Linc-FarmLinc-Website) alongside this one under ~/Github/lincza/. They are listed here as products but must not bleed their colours/branding into linc.co.za.

Analytics

  • Google Analytics 4 tag G-E7E2CPRBN9 is deployed via the gtag.js snippet at the top of _includes/linc_head.html (so it loads on every page).
  • LinkedIn Insight Tag partner ID 6706090 is present on the live site.