# generator-reapp

> React/Redux client application

Latest version **0.1.2** (published 2016-04-26) · MIT license · 0 weekly downloads

## Install

```sh
npm install generator-reapp
pnpm add generator-reapp
yarn add generator-reapp
bun add generator-reapp
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.2 |
| Published | 2016-04-26 |
| First published | 2016-01-25 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 8 |
| Author | Marco Pegoraro |
| Maintainers | marcopeg |
| Keywords | yeoman-generator, react, redux, client, app |

## Links

- npm: https://www.npmjs.com/package/generator-reapp
- Repository: https://github.com/marcopeg/generator-reapp
- Homepage: https://github.com/marcopeg/generator-reapp#readme
- Issues: https://github.com/marcopeg/generator-reapp/issues
- npm.io page: https://npm.io/package/generator-reapp

## Dependencies (3)

- [lodash](https://npm.io/package/lodash.md) ^4.0.0
- [fs-extra](https://npm.io/package/fs-extra.md) ^0.26.4
- [yeoman-generator](https://npm.io/package/yeoman-generator.md) ^0.22.x

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 0.1.2 (latest) — 2016-04-26
- 0.1.1 — 2016-04-26
- 0.1.0 — 2016-04-24
- 0.0.28 — 2016-04-13
- 0.0.27 — 2016-04-13
- 0.0.25 — 2016-03-30
- 0.0.24 — 2016-03-22
- 0.0.23 — 2016-03-22
- 0.0.22 — 2016-03-20
- 0.0.21 — 2016-03-18
- 0.0.20 — 2016-02-13
- 0.0.19 — 2016-02-10
- 0.0.18 — 2016-02-03
- 0.0.17 — 2016-02-02
- 0.0.16 — 2016-02-02
- … 14 more at https://npm.io/package/generator-reapp/versions

## README

# Yeoman React App Generator

> This is a [Yeoman generator](http://yeoman.io/learning/) which helps you dealing with a 
_[React](https://facebook.github.io/react/)/[Redux](http://redux.js.org/)_ application.

In order to work with this tool and the _React_ environment you need _[NodeJS 4.2+]()_ available on your machine. On a _Mac_ I suggest to install _[NodeJS](https://nodejs.org)_ using _[Brew](http://brew.sh/)_ ([click here for a tutorial](https://changelog.com/install-node-js-with-homebrew-on-os-x/)).

If you are new to _Yeoman_ you should install it:

	npm install -g yo
	
And then you can install `generator-reapp` (this package):

	npm install -g generator-reapp
	
Now _Reapp_ is ready to use on your development machine.

## Scaffold a React Client App

The first thing you may want to do with _Reapp_ is to scaffold a brand new _React Client Application_:

	yo reapp myNewApp
	
This command will guide you through the setup and eventually will **create a new folder** where to generate all the files that you need to work with _React_.

> If you already know which name to give to your app you should run `yo reapp myNewApp`.

Once the generator finish its job you can run your app:

	cd myNewApp
	npm start

> The newly generated application comes from 
> [es6-react-client](https://github.com/marcopeg/es6-react-client) project and you will
> find more informations about the file structure in it's 
> [readme](https://github.com/marcopeg/es6-react-client/blob/master/README.md).
> 
> The general architecture of this _React/Redux_ client application is explained in 
> details in the [React Fast & Right](http://noblackmagic.com/reactjs-book/) 
> book _(early stage writing)_.

## Scaffold a new Component

The most common piece of a _React_ application is a _dumb component_, so a _Component_ which doesn't know about the whole application and can be **coded in complete isolation** from it.

	yo reapp:component SpeedIndicator
	
This command will guide you throth the setup and you may optionally build a _Unit Test_ for your _Component_ and a _Styleguide_ page that load it.

The best way to work on a newly generated component is to run his _Styleguide_ page:

	npm start SpeedIndicator

> A _Styleguide_ is a dull application that renders one single component in many 
> different ways and allows for **isolated develpment and manual testing**.
> Give it a try!

---
_Source: https://npm.io/package/generator-reapp · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
