Skip to content

parfait-code/TheNews

Repository files navigation

TheNews 📰

Version License

📱 Description

TheNews est une application moderne d'actualités conçue exclusivement pour mobile, développée avec Ionic React. Elle offre une expérience utilisateur fluide et intuitive pour consulter les dernières actualités en temps réel.

✨ Fonctionnalités Principales

  • Interface utilisateur intuitive et moderne
  • Actualités en temps réel
  • Mode hors-ligne
  • Favoris et marque-pages
  • Partage d'articles
  • Personnalisation du flux d'actualités
  • Support multilingue

⚙️ Caractéristiques Techniques

  • Framework : Ionic React 8.5.0
  • Base : React 19.0.0
  • Navigation : React Router 5.3.4
  • Stockage local : @ionic/storage-angular 4.0.0
  • Support Android natif via Capacitor 7.2.0
  • Tests unitaires avec Vitest
  • Interface utilisateur réactive et moderne

🛠️ Fonctionnalités Capacitor

  • Gestion du clavier
  • Gestion de la barre de statut
  • Retour haptique
  • Stockage des préférences
  • Support complet Android

🚀 Installation

  1. Cloner le repository

    git clone https://github.com/parfait-code/TheNews.git
  2. Installer les dépendances

    npm install
  3. Lancer en mode développement

    npm run dev

🔧 Commandes de Build

# Build pour le web
npm run build

# Build pour Android
ionic capacitor build android

# Build pour la production
ionic build --prod

📦 Scripts Disponibles

  • npm run dev : Lancement en mode développement
  • npm run build : Construction de l'application
  • npm run preview : Prévisualisation de la version de production
  • npm run test : Exécution des tests
  • npm run test:ui : Tests avec interface utilisateur
  • npm run test:coverage : Rapport de couverture des tests
  1. Redémarrez le serveur de développement

📱 Installation de l'APK

L'APK de debug est disponible dans :

android/app/build/outputs/apk/debug/app-debug.apk

Pour installer :

  1. Activez le mode développeur sur votre appareil Android
  2. Autorisez l'installation depuis des sources inconnues
  3. Installez l'APK

🧪 Tests

Structure des Tests

src/
  └── __tests__/
      ├── components/
      ├── pages/
      └── services/

Exécution des Tests

# Tests unitaires
npm run test

# Tests avec UI
npm run test:ui

# Couverture des tests
npm run test:coverage

Les rapports de couverture sont générés dans : coverage/index.html

Tests E2E

# Lancer les tests E2E
npm run test:e2e

🎯 Objectifs du Projet

  • Fournir une expérience utilisateur optimale sur mobile
  • Offrir un accès rapide aux actualités
  • Permettre une consultation hors-ligne
  • Assurer une performance optimale
  • Respecter les bonnes pratiques de développement

📋 Prérequis

  • Node.js
  • npm ou yarn
  • Ionic CLI
  • Android Studio (pour le développement Android)

🤝 Contribution

Les contributions sont les bienvenues ! Voici comment vous pouvez contribuer :

  1. Fork le projet
  2. Créez votre branche (git checkout -b feature/AmazingFeature)
  3. Committez vos changements (git commit -m 'Add some AmazingFeature')
  4. Push vers la branche (git push origin feature/AmazingFeature)
  5. Ouvrez une Pull Request

📈 Roadmap

  • Amélioration des performances
  • Ajout de nouvelles sources d'actualités
  • Intégration de notifications push
  • Support Android
  • Mode sombre/clair

📄 Licence

Ce projet est sous licence MIT

📞 Contact

🐛 Signalement de Bugs

Pour signaler un bug, veuillez créer une issue sur GitHub


© 2024 Kouam Parfait. Tous droits réservés.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages