AI Context for softinstigate.com

Purpose: This document gives AI agents a compact, actionable overview of this repository to speed up future tasks (edits, features, debugging, content updates).

Project Overview

• Static website built with Eleventy (11ty) + Liquid/LTR markdown.
• Bilingual: Italian (it) and English (en). Root redirects to /it/ or /en/ based on browser language.
• Content organized in en/ and it/ folders; shared layouts/partials in _includes/ and shared data in _data/.

Tech Stack

• Eleventy 2.x, markdown-it (+ attrs, anchor, toc-done-right, container), syntax highlight plugin.
• Sass -> CSS via sass (npx sass) from scss/ to css/.
• Front-end libs: jQuery, Bootstrap 4.5, Slick Carousel, GSAP + ScrollTrigger, AOS, imagesloaded, viewport-checker.
• Cookie/CMP: Iubenda. Analytics: Plausible (referenced in privacy). Hotjar snippet present.
• Node engines: >=18 (pipeline uses Node 20). engineStrict: true.

Scripts & Build

• npm start: cleans _site, builds Sass, runs Eleventy --serve with BrowserSync (8080; UI 3001).
• npm run build: cleans _site, builds Sass, runs Eleventy (output in _site/).
• npm run watch:sass, npm run watch:eleventy for focused dev.

Eleventy Config Highlights (.eleventy.js)

• PassthroughCopy for static assets (images, css, js, favicons to root, robots.txt, config.json), blog images, portfolio case images, docs.
• Markdown library configured with: attrs, anchor, toc-done-right (ul), container 'block'.
• BrowserSync 404 middleware serving _site/error.html without redirect.
• Filters: toUTCString, removeLang (removes leading /en/ or /it/ from URLs), exclude, debugger.
• Collections: italianPosts and englishPosts via tags ('post','it' or 'en').
• HTML minification transform with html-minifier (keeps inline code blocks unbroken).

Internationalization

• en/en.json and it/it.json provide { language, locale } used by templates.
• Translations live in _data/i18n.json, accessed via ``.
• Header includes language switcher that uses removeLang to normalize URLs.

Content Structure

• Home pages: en/index.html, it/index.html use layout _includes/home.html and translations from _data/i18n.json.
• Main sections:
  • Home: hero, value/solutions, manifesto teaser, services (leadership/team/tech/roadmap), portfolio teaser, team/labs, clients carousel.
  • Portfolio: index + individual cases under en/portfolio/, it/portfolio/. Portfolio items rendered by _includes/portfolio-items.html through collections.case filtered by case.data.lang.
  • Partners: en/partners/, it/partners/ page lists partners (MongoDB, Cloudinary, Percona, Sinthera, Sease) with CTAs.
  • Labs: en/labs.html, it/labs.html with Technology Radar include (_includes/pages/radar.html) reading config.json.
  • Blog: en/blog/, it/blog/ with layout _includes/pages/blog.html; posts expected in */blog/posts/ with tags for collections.
  • Jobs: */jobs.html and job detail pages (it: job-developer.html, job-junior-developer.html).
  • Manifesto: */manifesto/ markdown with layout _includes/pages/manifesto.html.
  • Contact: */contact.html with email/phone/socials/address.
  • Privacy: */privacy.html (IT text, EN disclaimer) with last update shown.

Data Sources

• _data/site.js: url (dev vs prod) and buildTime timestamp.
• _data/i18n.json: UI strings for both locales.
• config.json: Technology Radar dataset used in Labs page.

Routing & SEO

• Root index.html: JS redirect to /it/ if browser language starts with 'it', else /en/.
• sitemap.liquid present to generate sitemap (and _site/sitemap.xml is part of build output).
• Meta tags present in select pages (e.g., Partners) for OG/Twitter.

Assets & Styling

• Sass source in scss/, compiled CSS in css/ (compressed).
• Fonts in fonts/, favicons in favicons/ (mapped to root via passthrough).
• Images in images/.

Deploy & Hosting

• CI: Bitbucket Pipelines builds with Node 20, preserves _site/ as artifact.
• Deploy: deploy.sh uploads _site/ to S3 with cache-control policies (assets long cache; HTML/XML/manifests no-cache; JSON short; robots.txt daily), then invalidates CloudFront.
• Environments:
  • Test: S3_BUCKET=dev.softinstigate.com, AWS_DEFAULT_REGION=eu-south-1.
  • Prod: S3_BUCKET=softinstigate.com, AWS_DEFAULT_REGION=eu-central-1.
  • CLOUDFRONT_ID differs per env.

Notable Templates (_includes/pages/)

• home.html, portfolio.html, single_case.html, partners, labs.html, blog.html, contact.html, jobs.html, job-description.html, manifesto.html, privacy.html, team.html, article.html, radar.html.
• Shared: header.html (lang switcher + menu), footer.html (legal + social + scripts), head.html (meta includes).

Conventions & Tips for Agents

• Language-aware content: many includes expect locale and t (translations). Ensure you set `` when creating new layouts/pages.
• Portfolio items: to add a case, create a file under */portfolio/ (or */portfolio/cases/), set layout: pages/single_case.html, title:, sitemap, and lang in frontmatter if used by collections; add imagery under corresponding */portfolio/cases/ (passthrough is configured for images).
• Blog posts should be tagged with 'post' and 'it' or 'en' for collections italianPosts/englishPosts.
• External scripts: check GDPR/cookie implications before adding new trackers; Iubenda is already integrated.
• When linking across languages, prefer using removeLang filter to normalize/transform URLs.

Quick Diagnostics

• Local dev: site at http://localhost:8080 (BrowserSync UI: http://localhost:3001).
• If 8080 busy: pass --port to Eleventy in scripts or free the port.
• Node version errors: use Node >=18 (prefer 20 LTS). engineStrict blocks older versions.
• Missing assets in build: confirm passthroughCopy patterns in .eleventy.js.
• 404 locally: BrowserSync serves _site/error.html via middleware.

Pending/Ideas

• Consider adding .nvmrc for Node 20 LTS to standardize dev envs.
• Optionally add a README section for content model (frontmatter fields) per page type.