# Project Context: Pyx Engineering AG (Hugo Website) ## 1. Corporate Identity * **Company:** Pyx Engineering AG * **Industry:** IT Consulting Services / [ML ops, technologies like Kafka, Elasticsearch] * **Tone of Voice:** Professional, precise, reliable, and high-quality (Swiss engineering standard). * **Language:** Provide a multilanguage website in English (US) and German (CH) - *Note: Always use Swiss-German spelling (no "ß", use "ss").* ## 2. Technical Stack * **SSG:** Hugo (v0.150 or newer)) * **Deployment:** manual deployment for now * **Auth:** HTTPS access to Gitea repo on https://git.jammann.ch/joe/pyx-website * **Styling:** logos available in EPS and PNG format. Choose whatever fits better ## 3. Content Architecture * **Services:** Located in `/content/services/`. Each service should have a dedicated page. * **Projects/References:** Essential for credibility. Format: Image, project scope, year, and services provided. * **Frontmatter Requirements:** Every `.md` file must include: `title`, `description` (for SEO), `date`, and `thumbnail`. * **Global Data:** Company address, phone, and UID are stored in `/data/company.yaml`. ## 4. Claude's Operational Guidelines * **Hugo Best Practices:** Use `partials` for reusable elements (Header/Footer). Use `shortcodes` for UI components in Markdown files. * **Image Handling:** Always use Hugo Resource Processing (`.Resize`, `.Fill`, `.Process "webp"`) to ensure fast load times. * **Clean Code:** Keep layouts modular. Avoid hardcoding strings; use i18n or data files where possible. * **SEO Focus:** Ensure proper `H1` to `H3` hierarchy. Meta descriptions should be concise and professional. ## 5. Current Roadmap & Tasks - [ ] Initialize project structure and Hugo theme. - [ ] Draft content for "About Us" and "Core Services". - [ ] Implement Swiss-compliant Imprint (Impressum) and Privacy Policy.