PostizMobile

Application mobile React Native (Expo) pour piloter une instance Postiz auto-hébergée depuis votre téléphone Android ou iOS.

---

Sommaire

1. Fonctionnalités
2. Prérequis
3. Installation & développement
4. Configuration de l'application
5. Architecture du projet
6. API Postiz utilisée
7. Build APK Android (EAS)
8. Build iOS (Expo Launch)
9. Pousser les modifications sur Gitea
10. Variables d'environnement & secrets
11. Dépannage

---

Fonctionnalités

Écran	Description
Calendrier	Vue mensuelle avec points de couleur par jour (indigo = planifié, vert = publié, rouge = erreur). Tap sur un jour pour voir les posts.
Posts	Liste filtrée (Tous / Queue / Publié / Brouillon / Erreur) avec pull-to-refresh et swipe gauche pour supprimer.
Composer	Éditeur de texte, sélecteur de canaux, date/heure, importation d'image galerie + upload, publier maintenant ou planifier.
Paramètres	Saisie de la clé API et de l'URL de base, test de connexion, sauvegarde sécurisée (SecureStore).
Notifications	Alertes locales automatiques quand un post passe à PUBLISHED ou ERROR (polling toutes les 15 minutes).

Thème : dark forcé (userInterfaceStyle: dark).
Authentification : clé API stockée dans expo-secure-store, jamais en dur dans le code.

---

Prérequis

Outil	Version minimale
Node.js	20 LTS
pnpm	10+
Expo Go (téléphone)	SDK 54 compatible
Compte EAS (pour APK)	gratuit sur expo.dev

npm install -g pnpm
npm install -g eas-cli

---

Installation & développement

1. Cloner le dépôt

git clone ssh://gitea@homegit.gyozamancave.fr:2222/billisdead/Postiz-android.git
cd Postiz-android

2. Installer les dépendances

pnpm install

3. Lancer le serveur de développement

pnpm --filter @workspace/postiz-mobile run dev

Le terminal affiche un QR code. Scannez-le avec Expo Go (Android) ou l'app Appareil photo (iOS) pour voir l'app en direct.

4. Ouvrir dans le navigateur (web preview)

http://localhost:<PORT>

Le port est assigné dynamiquement par l'environnement Replit.

---

Configuration de l'application

Au premier lancement, l'écran Paramètres s'affiche car aucune clé n'est configurée.

1. URL de base : https://votre-instance-postiz.fr/public/v1
2. Clé API : générée depuis votre instance Postiz → Settings → API Keys
3. Appuyez sur Test Connection pour valider
4. Appuyez sur Save Settings

La clé est chiffrée et stockée localement via expo-secure-store. Elle n'est jamais envoyée à un service tiers.

---

Architecture du projet

artifacts/postiz-mobile/
├── app/
│   ├── _layout.tsx              # Root layout : providers, fonts, notifications
│   └── (tabs)/
│       ├── _layout.tsx          # Tab bar (NativeTabs iOS 26+ / Tabs classique)
│       ├── index.tsx            # Écran Calendrier
│       ├── posts.tsx            # Écran Liste des posts
│       ├── compose.tsx          # Écran Composer
│       └── settings.tsx         # Écran Paramètres
├── components/
│   ├── ChannelChip.tsx          # Chip de sélection de canal
│   ├── ErrorBoundary.tsx        # Gestionnaire d'erreurs global
│   ├── PostCard.tsx             # Carte post avec swipe-to-delete
│   └── StatusBadge.tsx          # Badge QUEUE / PUBLISHED / ERROR / DRAFT
├── constants/
│   └── colors.ts                # Palette dark theme
├── context/
│   └── PostizContext.tsx        # Client axios + SecureStore (apiKey, baseUrl)
├── hooks/
│   ├── useColors.ts             # Tokens couleur selon le thème
│   └── useNotifications.ts      # Permissions + polling + notifications locales
├── assets/
│   └── images/
│       └── icon.png             # Icône générée par IA
└── app.json                     # Config Expo (permissions, plugins, thème)

Dépendances principales

Package	Usage
expo-router	Navigation file-based
axios	Client HTTP vers l'API Postiz
expo-secure-store	Stockage chiffré de la clé API
react-native-calendars	Vue calendrier mensuelle
@react-native-community/datetimepicker	Sélecteur date/heure dans Composer
expo-image-picker	Accès galerie photos
expo-notifications	Notifications locales de statut
expo-task-manager	Tâche de fond pour le polling
@tanstack/react-query	Cache et refetch des données API

---

API Postiz utilisée

Base URL configurée par l'utilisateur (ex. https://postiz.example.com/public/v1).

Méthode	Endpoint	Usage
GET	/integrations	Lister les canaux (Twitter, LinkedIn, etc.)
GET	/posts?startDate=&endDate=	Posts sur une plage de dates
POST	/posts	Créer / planifier un post
DELETE	/posts/:id	Supprimer un post
POST	/upload	Uploader une image (multipart)

Exemple de payload POST /posts

{
  "type": "schedule",
  "date": "2025-01-15T10:00:00.000Z",
  "content": [
    {
      "content": "Mon super post 🚀",
      "image": [{ "id": "upload-id", "path": "/uploads/photo.jpg" }]
    }
  ],
  "integrations": ["integration-id-twitter", "integration-id-linkedin"]
}

Pour publier immédiatement, utilisez "type": "now".

---

Build APK Android (EAS)

Prérequis : compte gratuit sur expo.dev et eas-cli installé.

1. Se connecter à EAS

npx eas login

2. Initialiser EAS dans le projet

cd artifacts/postiz-mobile
npx eas init

Cela génère un projectId dans app.json.

3. Fichier de configuration EAS

Déjà inclus dans le dépôt : artifacts/postiz-mobile/eas.json est présent, vous pouvez passer cette étape.

Si vous souhaitez le recréer manuellement :

{
  "cli": {
    "version": ">= 16.0.0"
  },
  "build": {
    "preview": {
      "android": {
        "buildType": "apk"
      }
    },
    "production": {
      "android": {
        "buildType": "app-bundle"
      }
    }
  },
  "submit": {
    "production": {}
  }
}

4. Lancer le build APK

# APK de test (sideload)
npx eas build --platform android --profile preview

# AAB pour le Play Store
npx eas build --platform android --profile production

Le build se fait dans le cloud EAS (~10-15 min). À la fin, EAS affiche un lien de téléchargement et un QR code pour récupérer le fichier .apk.

5. Installer l'APK sur votre téléphone

# Via adb
adb install postiz-mobile.apk

# Ou scannez le QR code affiché par EAS

6. Publier l'APK comme Release Gitea

Une fois le .apk téléchargé depuis EAS, attachez-le à une release Gitea pour le rendre disponible directement depuis le dépôt :

1. Allez sur https://homegit.gyozamancave.fr/billisdead/Postiz-android/releases
2. Cliquez New Release
3. Choisissez un tag (ex. v1.0.0) et un titre
4. Glissez-déposez le fichier .apk dans la zone de pièces jointes
5. Cliquez Publish Release

L'APK sera alors téléchargeable directement depuis la page du dépôt Gitea.

Permissions Android déclarées

READ_EXTERNAL_STORAGE
WRITE_EXTERNAL_STORAGE
READ_MEDIA_IMAGES     <!-- photos galerie -->
RECEIVE_BOOT_COMPLETED
VIBRATE               <!-- notifications -->

---

Build iOS (Expo Launch)

Disponible uniquement via Replit Expo Launch (soumission App Store automatisée).

1. Dans Replit, cliquez sur le bouton Publish
2. Sélectionnez Expo Launch
3. Suivez le wizard (compte Apple Developer requis)

Note : la publication Google Play n'est pas encore supportée par Expo Launch — utilisez EAS pour Android.

---

Pousser les modifications sur Gitea

Le dépôt distant est : ssh://gitea@homegit.gyozamancave.fr:2222/billisdead/Postiz-android.git

La clé SSH utilisée est stockée dans la variable d'environnement GITEA_SSH_KEY (côté Replit).

Push depuis votre machine locale

# Ajouter le remote (une seule fois)
git remote add gitea ssh://gitea@homegit.gyozamancave.fr:2222/billisdead/Postiz-android.git

# Pousser
git push gitea main

Assurez-vous que votre clé SSH publique est ajoutée dans Gitea → Paramètres utilisateur → SSH / GPG Keys.

Push depuis Replit (via script)

Depuis Replit, les commandes git push directes sont protégées. Utilisez le script de bundle :

# Créer le bundle
git bundle create /tmp/postiz.bundle main

# Cloner le bundle et pousser
git clone /tmp/postiz.bundle /tmp/repo_push
cd /tmp/repo_push
git remote add gitea ssh://gitea@homegit.gyozamancave.fr:2222/billisdead/Postiz-android.git
GIT_SSH_COMMAND="ssh -i ~/.ssh/id_ed25519 -o StrictHostKeyChecking=no -p 2222" \
  git push --force gitea main

---

Variables d'environnement & secrets

Variable	Stockage	Description
GITEA_SSH_KEY	Replit Secrets (shared)	Clé SSH privée pour push vers Gitea
SESSION_SECRET	Replit Secrets	Secret de session (API server)

Les variables côté app (clé API Postiz, URL) sont saisies par l'utilisateur dans l'écran Paramètres et stockées dans expo-secure-store — elles ne transitent jamais dans le code source.

---

Dépannage

L'app affiche "Not Configured" sur tous les écrans

→ Allez dans l'onglet Paramètres, entrez votre clé API et URL, puis tapez Test Connection.

"Connection failed" dans les Paramètres

• Vérifiez que l'URL se termine bien par /public/v1
• Vérifiez que la clé API est valide (générée dans Postiz → API Keys)
• Vérifiez que votre instance Postiz est accessible depuis internet

Pas de notifications reçues

• Acceptez les permissions de notification au premier lancement
• Le polling se fait toutes les 15 minutes — attendez un cycle complet
• Sur Android, vérifiez que les notifications de l'app ne sont pas désactivées dans les paramètres système

Erreur Metro "module not found"

pnpm install
# Puis redémarrer le workflow Expo

Le calendrier ne charge pas les posts

• Vérifiez que l'API Postiz supporte les paramètres startDate / endDate sur GET /posts
• Consultez les logs réseau : dans Expo Go, secouez l'appareil → Open Debugger

Build EAS échoue

# Vérifier la version Expo
npx expo --version

# Vérifier la cohérence des packages
npx expo install --check

---

Contribuer

1. Forkez sur Gitea : https://homegit.gyozamancave.fr/billisdead/Postiz-android
2. Créez une branche feature : git checkout -b feature/ma-fonctionnalite
3. Committez vos changements
4. Poussez et ouvrez une Pull Request

---

Généré avec ❤️ sur Replit — PostizMobile v1.0.0