Skip to content
A CLI tool to create React + Node apps with just one command
JavaScript HTML CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github/ISSUE_TEMPLATE
src
template
.eslintignore
.eslintrc
.eslintrctemp
.gitignore
.npmignore
.stylelintignore
.stylelintrc
.travis.yml
CODE_OF_CONDUCT.md
CONTRIBUTING.md
LICENSE.md
README.md
babel.config.json
index.js
logo.png
package-lock.json
package.json

README.md

CReate A Node Application

🔋 A CLI tool to create React + Node apps with just one command (batteries included)

Maintainability

Technologies

As soon as you bootstrap a new project, you will have an application running with:

  • Node.js backend
  • React.js frontend

Under the hood it uses Webpack, Babel, ESLint and StyleLint with a few other plugins enabling a powerful development workflow, such as server live reload with nodemon and more. All preconfigured out of the box, so that you can focus on the important stuff!

Quick Start

💡 To get up and running with your first Crana app, fist install Crana globally:

npm i -g crana

Initialize your app

crana init <projectName> [projectFolder]

...and you are ready to go!

💻 Now start developing!

crana dev

This will fire up the frontend and the backend concurrently in development mode.. Just edit files under src and see what happens!

Usage

Basic Commands

Command Description
crana -V Outputs crana's version
crana -h Show available commands

Main Commands

Command Description
⭐️ crana init [projectFolderName] Create a new crana project
💫 crana dev Concurrently starts the frontend and the backend in development mode
📡 crana dev:client Starts the webpack development server for the frontend
📊 crana dev:server Starts the node.js backend in development mode with live-reload
🚙 crana build:client Creates a production build for the frontend application

Util Commands

Command Description
🔍 crana lint:client Executes eslint and styleling in autofix mode for your client files (src/client + src/shared)
🔍 crana lint:server Executes eslint in autofix mode for your server files (src/server + src/shared)
📚 crana count-lines See how many LOC you've already written

Project structure

The interesting files for you are all located in the src folder. The src folder has three subfolders:

  • client
  • server
  • shared

As you can imagine, the client folder contains all files for React and the server folder contains all files for Node.js backend. The shared folder contains code you would like to share between client and server. This is a good place for e.g. utility functions, domain logic etc.

NOTE:Be aware that the server files are not transpiled and thus don't support certain features like ES6 imports. This also the reason why all code in the shared folder must be executable with your current node.js version.

Known issues

Windows Linux Subsystem

If you're using Windows Linux Subsystem, eslint will not immediatly work. You need to edit the path under .vscode/settings.json. Replace C:/mnt/c with C: and it should work.

Contributing

⚠️ Crana is in early stage of development and may not meet all your requirements. That's why contributions of any kind are highly appreciated, as the best tools are built by communities!

Pull requests are always welcome. Please have a look at CONTRIBUTING.md and open an issue before submitting a pull request.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Code of conduct

Have a look at CODE_OF_CONDUCT.md

You can’t perform that action at this time.