MOTOKO BASE

Documentation

Introduction

Ce qu’est Motoko Base, ce qu’il inclut et comment utiliser cette documentation.

Ouvrir dansChatGPT (s’ouvre dans un nouvel onglet)Claude (s’ouvre dans un nouvel onglet)Cursor (s’ouvre dans un nouvel onglet)Ce qu’est Motoko Base, ce qu’il inclut et comment utiliser cette documentation.

Motoko Base est un starter SaaS full-stack prêt pour la production avec Next.js. Ce n’est pas un produit fini pour l’utilisateur final — c’est une base que vous clonez, configurez et étendez en conservant les mêmes patterns d’auth, de données, de facturation et d’intégrations.

Utilisez cette documentation pour comprendre comment le starter est structuré, ce qui est livré d’usine et comment le personnaliser pour votre propre produit.

Qu’est-ce que Motoko Base ?

Motoko Base vous fournit un squelette d’application complet : tableau de bord authentifié, routes protégées, couche base de données, abstraction de facturation, e-mail transactionnel, démos optionnelles de stockage et d’IA, infrastructure d’analytics et de monitoring, pages marketing et outillage développeur.

L’objectif est simple — construisez votre SaaS, pas son infrastructure. Vous vous concentrez sur les fonctionnalités produit ; le starter gère le câblage répétitif dont chaque SaaS a besoin.

Qu’est-ce qui est inclus dans le starter ?

Fondation principale

  • Authentification — Better Auth avec e-mail/mot de passe, vérification, réinitialisation du mot de passe et OAuth Google et GitHub optionnels
  • Base de données — PostgreSQL avec Drizzle ORM, schémas typés et migrations
  • Facturation — Intégration Polar avec checkout, abonnements, webhooks et entitlements (échec soft si non configuré)
  • E-mail — Resend pour le mail transactionnel (vérification, réinitialisation du mot de passe, templates)
  • Shell du dashboard — Navigation latérale, paramètres, thème et layout protégé
  • Site marketing — Landing page, section tarifs, docs et changelog
  • Analytics et monitoring — Intégrations PostHog et Sentry (optionnelles, non bloquantes)
  • Infrastructure prête pour l’IA — Vercel AI SDK avec un fournisseur compatible OpenAI

Fonctionnalités démo

Les démos se trouvent sous le groupe de navigation Demos. Elles montrent une architecture réelle que vous pouvez copier dans votre produit ou supprimer entièrement :

  • Link Manager — CRUD de liens avec routes publiques de redirection (/r/[slug])
  • File Storage — Uploads Cloudflare R2 avec contrôles de propriété
  • AI Email — Endpoint IA en streaming intégré au dashboard

Les démos sont volontairement retirables. Consultez le README pour une checklist de suppression sûre.

À qui s’adresse-t-il ?

Motoko Base est conçu pour les développeurs et petites équipes qui veulent livrer un produit SaaS plus vite sans assembler le même stack depuis zéro à chaque fois.

C’est un bon choix si vous :

  • Voulez une application réelle et fonctionnelle — pas un template minimal avec des routes placeholder
  • Préférez des patterns opinionnés à une toile blanche (server actions, dossiers par feature, validation Zod)
  • Avez besoin d’intégrations production câblées mais qui échouent soft quand les variables d’environnement manquent
  • Prévoyez de posséder et modifier le code — ajouter des features, retirer des démos, changer de fournisseurs

Il ne s’adresse pas aux non-développeurs ni aux équipes qui cherchent un builder no-code.

Comment cette documentation est organisée

Les docs sont des fichiers MDX versionnés sous content/docs/, rendus sur /docs avec Fumadocs.

  • Barre latérale — pilotée par les fichiers meta.json de chaque dossier ; ajoutez des pages en créant un MDX et en le listant dans le meta.json du dossier
  • Premiers pas — installation et configuration initiale (commencez ici)
  • Guides — approfondissements sur les features et intégrations (ajoutés au fur et à mesure que la doc grandit)
  • Changelog — mises à jour produit sur /changelog, aussi en MDX sous content/changelog/

Chaque page accepte le frontmatter (title, description) et le Markdown standard. Blocs de code, titres et liens croisés fonctionnent dès le départ.

Pour les règles d’architecture orientées agents, voir AGENTS.md à la racine du dépôt.

Essayer la démo en direct

Avant d’installer en local, explorez l’application en cours d’exécution :

Ouvrir la démo en direct →

La démo vous permet de vous connecter, de parcourir le dashboard et d’essayer les démos incluses — authentification, UI de facturation, paramètres, Link Manager, Storage et AI Email — pour voir comment le starter se comporte en pratique.

Prochaines étapes

Prêt à configurer votre propre copie ?

Installation — Clonez, configurez les variables d’environnement, lancez les migrations et démarrez le serveur de développement.

Structure du projet — Où vit le code et comment les dossiers sont organisés.

Continuer →