Ontwikkelaars & API

Technische documentatie voor integratie en samenwerking met Swimmigo.

🏗️ Architectuur

Swimmigo is gebouwd als een moderne webapplicatie met een mobiele app voor iOS en Android. De architectuur volgt het JAMstack-principe met server-side rendering voor optimale SEO en prestaties.

Tech Stack

  • Framework: Next.js 15+ (App Router), TypeScript
  • Styling: Tailwind CSS, Framer Motion
  • Database: MongoDB Atlas — multi-collection architecture per language (blog_posts_nl/en/de/fr/es)
  • Hosting: Vercel (automatic HTTPS, global CDN, ISR caching)
  • Mobile: React Native — iOS (App Store) + Android (Google Play)
  • Analytics: Google Analytics 4

🌍 Meertalige Architectuur

Swimmigo ondersteunt 5 talen via een enkel domein (swimmigo.com). De architectuur gebruikt Next.js middleware voor taal-detectie en routing:

TaalURL PrefixCollectie
Nederlands 🇳🇱/nl/blog_posts_nl
English 🇬🇧(default, none)blog_posts_en
Deutsch 🇩🇪/de/blog_posts_de
Français 🇫🇷/fr/blog_posts_fr
Español 🇪🇸/es/blog_posts_es

Blogposts worden dagelijks automatisch vertaald van Nederlands naar alle andere talen via OpenAI GPT-4.1-mini. Matching gebeurt via het <code>baserowId</code> veld.

📊 Structured Data & SEO

Alle pagina's implementeren JSON-LD structured data voor optimale zichtbaarheid in Google Search, Google AI Overviews, en AI chatbots:

  • Organizationmet logo, contactgegevens, sameAs profielen
  • WebSitemet SearchAction en Speakable specificatie
  • BlogPosting / Articlemet auteur, publicatiedatum, afbeelding
  • FAQPagemet Question/Answer pairs per blogpost
  • BreadcrumbListvoor navigatie-context

🤖 AI Readiness

Swimmigo is geoptimaliseerd voor AI crawlers en LLM-indexering:

  • robots.txtExpliciete toegang voor GPTBot, ChatGPT-User, Google-Extended, PerplexityBot, ClaudeBot, OAI-SearchBot, Applebot, Meta-ExternalAgent
  • llms.txtswimmigo.com/llms.txt
  • llms-full.txtswimmigo.com/llms-full.txtVolledige sitemap met alle 94+ blogposts
  • sitemap.xmlDynamisch gegenereerd met hreflang alternates voor alle 5 talen
  • image-sitemap.xmlBlog afbeeldingen voor Google Images

🔌 API Endpoints

Swimmigo biedt de volgende publieke API endpoints:

EndpointBeschrijving
GET /api/cms/slug-mapVolledige slug-map voor alle blogposts per taal
POST /api/contactContactformulier endpoint
POST /api/indexnowIndexNow protocol voor directe zoekmachine-indexering
GET /sitemap.xmlDynamische sitemap met alle paginas en blogposts
GET /image-sitemap.xmlImage sitemap voor Google Images indexering

📬 Contact

Voor technische vragen of integratieverzoeken: <a href="mailto:hello@swimmigo.com">hello@swimmigo.com</a>