AGENTS.md

What this project is

Discount Disko is a static Eleventy site with referral/discount landing pages. Each page targets a brand (Vinted, Kraken, Sklum, …) in a specific locale and exists to rank in search engines and convert visitors into clicks on a referral link or code. SEO performance is the product: treat every copy, title, or URL change as an SEO decision, not just a content edit.

SEO rules (most important)

• Never change a permalink of an existing page. URLs are keyword-rich and carry the ranking; changing one throws that away. New pages get a descriptive, keyword-rich permalink in the page's language.
• Keyword differentiation matters. Every page targets its own keyword set (e.g. "Vinted kortingscode", "gratis tegoed", "uitnodigingslink"). When writing or editing copy, keep the target keywords in the title, description, intro copy, and FAQ. Don't flatten pages of the same brand/locale into identical phrasing — differentiate wording between pages so they don't compete with each other.
• Preserve freshness signals. Titles use a <date> placeholder (computed in _data/eleventyComputed.js), body copy references ``, and the sitemap lastmod is kept fresh via the pageDate filter in .eleventy.js. Keep these intact when editing pages.
• Write natural, native copy in the page's locale. No machine-translated-sounding text; match the tone of existing pages in that locale.
• Keep structured content. FAQ entries (in index.11tydata.js files) double as long-tail keyword content — questions should read like real search queries.
• Outbound referral links use target="_blank" rel="external noopener noreferrer".

Structure

• <brand>/<locale>/index.njk — landing page: front matter (title, description, permalink, code block texts) plus body copy.
• <brand>/<locale>/index.11tydata.js — page data, mainly the faq array.
• _data/types/<brand>.js — brand config: name, company, color, and referral links/codes per locale.
• _data/i18n.js — locale strings; _data/eleventyComputed.js — computed title date and lastmod.
• _includes/layouts/base.njk and _includes/partials/ — layout and shared partials (code block, head, header, footer).
• .eleventy.js — collections, filters (codeLink, type, pageDate, markdown), HTML minification. Output goes to public/.

Adding a page

1. Copy an existing page of the same brand (or a similar brand) as a starting point.
2. Pick a unique, keyword-rich permalink and differentiate the keyword set from existing pages.
3. Add or update the brand config in _data/types/ if needed.
4. Write locale-native copy and FAQ targeting the chosen keywords.

Development

• yarn serve — dev server (Browsersync on port 8000).
• yarn build / yarn build:production — asset build (gulp) + Eleventy.

Conventions

• Follow .editorconfig (2-space indent for JS/JSON, final newline, LF).
• Always add dangling commas where appropriate.
• Match the comment style and amount of the file you're editing; comment sparingly.
• Keep changes small and DRY — prefer the minimal change a senior developer would make.