React Workshop

Ce workshop permet de découvrir React et son écosystème par la pratique, étape par étape !

Le sujet

Lors de ce workshop, nous allons développer une application web permettant de gérer ses vins préférés* !

Les principales fonctionnalités de l'application sont :

Lister les vins par région viticole,
Afficher la fiche détaillée d'un vin,
Aimer un vin,
Ajouter un commentaire sur un vin.

* L'abus d'alcool est dangereux pour la santé, à consommer avec modération ;-)

Les pré-requis techniques

Les pré-requis techniques sont les suivants :

Node (version 4.x ou 5.x) et NPM (version 3.x)
Git
Atom
React Developer Tools

Node.js

Téléchargez et installez la version de Node.js correspondant à votre système d'exploitation, en suivant les indications disponibles sur le site officiel : https://nodejs.org/en/download/

Vérifiez l'installation en lançant les commandes suivantes dans un terminal :

$ node -v
v4.4.0

$ npm -v
3.8.1

Si npm n'est pas en version 3.x, vous pouvez effectuer la mise à jour grâce à la commande suivante : npm upgrade -g npm

Git

Téléchargez et installez la version de Git correspondant à votre système d'exploitation, en suivant les indications disponibles sur le site officiel : https://git-scm.com/downloads

Vérifiez l'installation en lançant la commande suivantes dans un terminal :

$ git --version
git version 2.7.3

Atom

L'éditeur préconisé pour le workshop est Atom.

Téléchargez et installez Atom, puis installez les packages suivants :

language-javascript-jsx
linter-eslint

Pour savoir comment gérer les packages d'Atom : https://atom.io/docs/latest/using-atom-atom-packages

React Developer Tools

Afin de disposer d'outils spécifiques à React dans votre navigateur web, installez React Developer Tools :

Pré-installer les dépendances

Pour pré-installer les dépendances NPM à l'avance, vous pouvez lancer le script install.sh qui lancera les commandes npm install dans les différentes étapes du workshop.

Nous vous recommandons également de télécharger un exemplaire des dépendances pour éviter les problèmes de réseau potentiels

Si les dépendances posent des problèmes, notamment au niveau des paquets natifs, n'hésitez pas a lancer un npm rebuild pour recompiler ces paquets sur votre machine.

API

L'application web s'appuie sur une API REST disponible dans le dossier api.

Pour démarrer le serveur exposant l'API, lancez les commandes suivantes :

$ cd api
$ npm install
$ npm start

Rendez-vous ensuite sur http://localhost:3000 pour parcourir la documentation des différentes routes disponibles.

Les étapes du workshop

Etape 0
- Mise en place des outils de build
  - webpack
  - webpack-dev-server
  - babel
  - eslint
- Création du premier composant React
Etape 1
- Ajout de tests unitaires sur le composant créé à l'étape 0
  - react-test-utils
  - mocha
  - chai
  - jsdom
Etape 2
- Création d'une application React basique
  - Découpage en composants
  - Interactions entre composants
  - Utilisation du state
- Utilisation de l'API (Appels AJAX)
  - Liste des régions viticoles,
  - Liste des vins d'une région
  - Détail d'un vin
- Bonnes pratiques React
  - PropTypes
  - "Dumb components" vs "Smart components"
Etape 3
- Single Page Applications
- Introduction à react-router
- Refactoring de l'étape 2 pour obtenir une SPA
Etape 4
- Ajout de fonctionnalités
  - Aimer un vin
  - Ajouter un commentaire
Etape 5
- Introduction à redux
- Refactoring de l'étape 4 avec redux
Etape 6
- Nouveaux patterns React
  - Classes
  - HOC
  - Stateless components
  - Contexts

doanduyhai/react-workshop