Developers & API
Technical documentation for integration and collaboration with Swimmigo.
🏗️ Architecture
Swimmigo is built as a modern web application with mobile apps for iOS and Android. The architecture follows JAMstack principles with server-side rendering for optimal SEO and performance.
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
🌍 Multi-Language Architecture
Swimmigo supports 5 languages via a single domain (swimmigo.com). The architecture uses Next.js middleware for language detection and routing:
| Language | URL Prefix | Collection |
|---|---|---|
| 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 |
Blog posts are automatically translated daily from Dutch to all other languages via OpenAI GPT-4.1-mini. Matching is done via the <code>baserowId</code> field.
📊 Structured Data & SEO
All pages implement JSON-LD structured data for optimal visibility in Google Search, Google AI Overviews, and AI chatbots:
Organization— with logo, contact info, sameAs profilesWebSite— with SearchAction and Speakable specificationBlogPosting / Article— with author, publish date, imageFAQPage— with Question/Answer pairs per blog postBreadcrumbList— for navigation context
🤖 AI Readiness
Swimmigo is optimized for AI crawlers and LLM indexing:
- robots.txt — Explicit access for 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 — Full sitemap with all 94+ blog posts
- sitemap.xml — Dynamically generated with hreflang alternates for all 5 languages
- image-sitemap.xml — Blog images for Google Images
🔌 API Endpoints
Swimmigo offers the following public API endpoints:
| Endpoint | Description |
|---|---|
GET /api/cms/slug-map | Full slug map for all blog posts per language |
POST /api/contact | Contact form endpoint |
POST /api/indexnow | IndexNow protocol for direct search engine indexing |
GET /sitemap.xml | Dynamic sitemap with all pages and blog posts |
GET /image-sitemap.xml | Image sitemap for Google Images indexing |
📬 Contact
For technical questions or integration requests: <a href="mailto:hello@swimmigo.com">hello@swimmigo.com</a>