Bien démarrer

Nutritor existe sous deux formes : une application mobile (Android, via un APK signé distribué sur GitHub Releases) et une version web accessible sur nutritor.netlify.app, sans installation.

Choix du projet : la version web de Nutritor est une page web simple (export statique React Native Web, npx expo export --platform web), sans manifest.json ni service worker. Ce n'est donc pas une PWA installable : le navigateur ne propose pas d'installation et le site lui-même n'est pas conçu pour fonctionner hors ligne. Cette orientation a été confirmée par l'éditeur ; pour un usage hors ligne durable, utiliser l'application Android.

Android — application installée

  1. Télécharger l'APK depuis la page GitHub Releases.
  2. Autoriser l'installation depuis une source inconnue si demandé par Android.
  3. Ouvrir l'application — elle demande la permission Caméra lors de la première utilisation du scanner (voir Permissions).
  4. Désinstallation : comme n'importe quelle application Android (Paramètres → Applications → Nutritor → Désinstaller). Les données sont stockées localement sur l'appareil (voir Données) et sont supprimées avec l'application.

Web — navigateur

Ouvrir nutritor.netlify.app dans un navigateur récent (Chrome, Safari, Firefox, Edge). Aucune installation n'est nécessaire. Un raccourci générique « Ajouter à l'écran d'accueil » peut être proposé par certains navigateurs mobiles, mais il s'agit d'un simple raccourci vers l'URL — pas d'une installation PWA avec fonctionnement hors connexion garanti pour l'application elle-même (l'encyclopédie et la base CIQUAL, en revanche, fonctionnent bien hors connexion une fois la page chargée — voir Hors connexion).

Sur le web, le scanner de codes-barres par caméra n'est pas disponible : une saisie manuelle du code EAN remplace le scan (voir Permissions et Limites connues).

Premier lancement

Le premier lancement suit ce parcours réel (basé sur OnboardingFlow.tsx et ModeOnboarding.tsx) :

  1. Écran de bienvenue — présentation en plusieurs étapes de l'application et de son positionnement (connaissance nutritionnelle, pas comptage de calories).
  2. Choix du mode Débutant / Expert — deux cartes cliquables ; ce choix personnalise la profondeur de l'interface (sections techniques masquées en mode Débutant). Il est modifiable à tout moment dans Paramètres → Interface.
  3. Écran principal (Journal) — l'application est utilisable immédiatement : profil, allergènes et objectifs peuvent être complétés plus tard via l'onglet Profil.

Aucun compte ni connexion n'est requis pour utiliser Nutritor : toutes les données restent sur l'appareil (voir Données et confidentialité).

Configuration initiale — l'IA (optionnelle)

L'intelligence artificielle (enrichissement de fiches, générateur de repas, Cuisine IA, mémoire digestive) est optionnelle — Nutritor reste pleinement utilisable sans elle (encyclopédie, base CIQUAL, journal, scanner). Pour l'activer : Paramètres → choisir un fournisseur (OpenRouter, Anthropic, OpenAI ou Ollama) → renseigner une clé API ou une URL locale. Détail complet dans Paramètres et la table de référence.