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:
| Taal | URL Prefix | Collectie |
|---|---|---|
| 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:
Organization— met logo, contactgegevens, sameAs profielenWebSite— met SearchAction en Speakable specificatieBlogPosting / Article— met auteur, publicatiedatum, afbeeldingFAQPage— met Question/Answer pairs per blogpostBreadcrumbList— voor navigatie-context
🤖 AI Readiness
Swimmigo is geoptimaliseerd voor AI crawlers en LLM-indexering:
- robots.txt — Expliciete toegang voor GPTBot, ChatGPT-User, Google-Extended, PerplexityBot, ClaudeBot, OAI-SearchBot, Applebot, Meta-ExternalAgent
- llms.txt — swimmigo.com/llms.txt
- llms-full.txt — swimmigo.com/llms-full.txt — Volledige sitemap met alle 94+ blogposts
- sitemap.xml — Dynamisch gegenereerd met hreflang alternates voor alle 5 talen
- image-sitemap.xml — Blog afbeeldingen voor Google Images
🔌 API Endpoints
Swimmigo biedt de volgende publieke API endpoints:
| Endpoint | Beschrijving |
|---|---|
GET /api/cms/slug-map | Volledige slug-map voor alle blogposts per taal |
POST /api/contact | Contactformulier endpoint |
POST /api/indexnow | IndexNow protocol voor directe zoekmachine-indexering |
GET /sitemap.xml | Dynamische sitemap met alle paginas en blogposts |
GET /image-sitemap.xml | Image sitemap voor Google Images indexering |
📬 Contact
Voor technische vragen of integratieverzoeken: <a href="mailto:hello@swimmigo.com">hello@swimmigo.com</a>