README.md

Deployed.pl React App Boilerplate

Basic production ready React application configuration.

Configuration based on Razzle and inspired by React Boilerplate

Quick start

Requirements

• node>=8.10
• yarn>=1.7
• python - to install virtualenv
• See Dockerfile for other dependencies

Installation

We are using python's virtualenv to create independent project environments.

1. Install python virtualevnwrapper.

2. Setup virtual environment

   mkvirtualenv --python=python3.5 project-name

   echo cd ${PWD} >> ~/.virtualenvs/project-name/bin/postactivate

3. Install nodejs in your virtualenv

   pip install nodeenv

   Install newest node 8 version. You can check available version using command nodeenv --list

   nodeenv -p --prebuilt --node=8.11.3

4. Install project dependencies

   yarn install

Commands

NOTE The boilerplate requires backend server providing graphql API.

Development

yarn start

Run development server at 127.0.0.1:3000.

Environment variables

You can use environment variable PORT to use another port and HOST to change default host. Another way is to set custom variables in .env files (dotenv) - check Razzle's documentation to learn more. *.local files are excluded from git.

Testing

yarn test

Runs all tests and returns coverage report.

yarn test:watch

Run tests in jest watch mode.

Linting

npm run lint

Pycharm (IntelliJ) configuration

Recommended IntelliJ plugins

• Es6 intentions
• EditorConfig
• NodeJS
• JS GraphQL
• Styled Components

Technology stack

• React
• MobX
• React Router
• React Loadable
• Styled Components
• GraphQL
• React Apollo
• React Helmet
• React Intl
• Razzle
• Express
• Jest
• Enzyme