Skip to content

This is repository serves as a boilerplate for a React-Redux application bundled using WebPack 4 and Babel to "transpile".

Notifications You must be signed in to change notification settings

eldrego/react-redux-starter-kit

Repository files navigation

React Redux Starter Kit

Hound

This is repository is created to help bootstrap a React-Redux application.

Requirements

  • node 8.9.0
  • npm ^6.0.1

Installation

Create a new project based on react-redux-starter-kit by doing the following:

$ git clone https://github.com/eldrego/react-redux-starter-kit.git <my-project-name>
$ cd <my-project-name>

Create your .env file and populate the relevant values based on the sample file .env-sample

Install dependencies

$ npm install
$ npm run start      # Compiles and launches application

If everything works, you should get a message indicating so. In development Application will be served on port 8080 Open the web browser to http://localhost:3000/login

Project Structure

The project structure presented in this starter kit is outlined below. This structure is only meant to serve as a guide.

├── public                # Transpiled react source code
└──src                    # React-redux related files
   ├── __tests__          # Unit tests
   ├── assets             # Assests - Images, stylesheets and
   │   ├── fonts          # Custom fonts for the application
   │   ├── images         # Images
   │   └── sass           # CSS files
   ├── components         # Collections of reducers/constants/actions
   ├── layouts            # Layouts for auth pages and other pages
   ├── pages              # Collections of landing pages for navigation items
   ├── redux              # Collections of reducers/constants/actions
   │   ├── actions        # Actions
   │   ├── reducers       # Reducers
   │   ├── constants.js   # Constants file
   │   └── store.js       # Redux store instance
   ├── routes             # Route declaration for the application  - private and public routes
   └── utils              # Utitily functions used in the application

Contributing

I am more than happy to accept contributions to the project. Contributions can be in the form of feedback, bug reports or even better - pull requests :)