https://github.com/mohebifar/racket

A complete starting app for developing universal React/Redux web apps with generators, best practices and more
https://github.com/mohebifar/racket

best-practices racket react redux universal yeoman-generator

Last synced: 5 days ago
JSON representation

A complete starting app for developing universal React/Redux web apps with generators, best practices and more

• Host: GitHub
• URL: https://github.com/mohebifar/racket
• Owner: mohebifar
• License: mit
• Created: 2015-10-10T17:15:01.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2016-08-19T23:08:46.000Z (over 8 years ago)
• Last Synced: 2024-12-14T14:44:10.620Z (8 days ago)
• Topics: best-practices, racket, react, redux, universal, yeoman-generator
• Language: JavaScript
• Homepage: https://racket-demo.herokuapp.com/
• Size: 73.2 KB
• Stars: 291
• Watchers: 10
• Forks: 14
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


  





  Generators, best practices and a complete starting app for developing universal React/Redux web app

  


  

  

  

  



# Racket

Racket is a yeoman generator for creating **universal/isomorphic** web applications. One of the pains for developers who want to use React or want to develop universal apps was knowing which libraries to choose and how tie them up! Racket responds to this issue by giving you the option to choose the tools/technologies that you prefer the most and offering a good structure that you can maintain for years!

**No need to copy or fork, just use the command-line generator!**

Creating, developing and maintaining a universal react app had never been so easy!

[Live running demo](https://racket-demo.herokuapp.com/)

> **Suggestion**: I do recommend to create a simple app with React + Redux yourself, before using Racket.

![Racket Screencast](https://www.dropbox.com/s/7ua7l3217gm1me4/racket-screencast.gif?dl=1)

# Installation

First, note that you need to use npm 3. If you have not upgraded to npm 3, run:

```

npm i -g npm@3

```

Install `yo` and `generator-racket` via npm:

```

npm i -g yo generator-racket

```

Create a directory for your app and cd into it:

```

mkdir my-awesome-app

cd my-awesome-app

```

Then run the following command to start creating your app.

```

yo racket

```

# Features

From each item with multiple options, you can choose the one you prefer:

- UI Library: [React](https://github.com/facebook/react)

- Flux Frameworks: [Redux](https://github.com/reactjs/redux)

  - [Redux Connect](https://github.com/makeomatic/redux-connect) included.

- Async actions: [Redux Thunk](https://github.com/gaearon/redux-thunk), [Redux Saga](https://github.com/yelouafi/redux-saga)

- Stylesheets: Sass, Less, PostCSS, CSS

- CSS Frameworks: [Bootstrap](https://github.com/twbs/bootstrap)

  - Option to include [React Bootstrap](https://github.com/react-bootstrap/react-bootstrap)

- Module Bundler: [Webpack](https://webpack.github.io/) + [Webpack Isomorphic Tools](https://github.com/halt-hammerzeit/webpack-isomorphic-tools)

- Router: [React Router](https://github.com/reactjs/react-router) + [React Router Redux](https://github.com/reactjs/react-router-redux)

- **Testing**

  - [Enzyme](https://github.com/airbnb/enzyme)

  - [Mocha](https://github.com/mochajs/mocha)

  - [Karma](https://github.com/karma-runner/karma)

# Generators

## Component

To generate a component run:

```

yo racket:component  [--stateless]

```

## Route

To generate a new route and component run:

```

yo racket:route 

```

## Redux module

To generate a [redux module](https://github.com/erikras/ducks-modular-redux) run:

```

yo racket:redux-module 

```