@lunde/create-react-app NPM

@lunde/create-react-app

A command line tool for creating React apps out of thin air with deployment strategies for Now, S3 + CloudFront, and AWS Lambda + API Gateway. This is a flexible alternative to the original CRA which has very stringent rules.

📦 What's in the ****ing box?

Apps are packaged with a variety of tools necessary for production React applications.

Build tools

Library	Description
Webpack 4	For building an serving the application
Babel 7	For compiling jsx and ES6 code to ES5
Jest	For testing components
Prettier	For formatting code, READMEs, and configs
ESLint	For linting the application
Yarn	For deterministic builds and monorepos
build-react-app	For configuring, building, and serving your app with Webpack
render-react-app	For server rendering and streaming your app
deploy-react-app	For deploying your app to the world

Application structure

Have a taste of it

Output targets

You can configure your app for static and server rendered builds. By default, you're getting a scalable SSR solution.

Routes and pages

Routing is accomplished with react-router-dom.

Code splitting

Routes are code split by react-broker which is a great tool that also provides component preloading and SSR capabilities that React.lazy presently lacks.

Styles and theming

CSS styles and themes are added to components with -ui and -ui/system.

Static assets

Apps uses file-loader and responsive-loader w/ sharp to include images, fonts, and other files in your bundle assets. When you import a file from your src/assets directory it will be loaded with file-loader when the extension doesn't match (jpe?g|png|webm) and responsive-loader when it does.

Built-in deployment strategies

You can technically deploy your app however you choose, but there are default strategies for:

Now static sites
GitHub Pages
S3 + CloudFront for static sites
Lambda + API Gateway for dynamic sites

🔧 Usage

# Use `npx`
npx @lunde/create-react-app my-app --now

# Or install it globally
yarn global add @lunde/create-react-app
create-react-app my-app --aws --static

`create-react-app <name> [--static] [--now] [--aws] [--apollo]`

When none of the optional arguments are defined, an SSR React app and no deployment strategy is created.

Argument	Type	Required	Description
name	`string`	`true`	The name of your app. This is also the name of the directory that will be created.
--static	`boolean`	`false`	Creates a static React app with no deployment strategy
--now	`boolean`	`false`	Creates a static React app with a Now deployment strategy
--aws	`boolean`	`false`	Creates an SSR React app with a Serverless Lambda + API Gateway deployment strategy
--aws --static	`boolean`	`false`	Creates a static React app with an S3 + CloudFront deployment strategy
--aws --apollo	`boolean`	`false`	Creates an SSR React Apollo app with a Lambda + API Gateway deployment strategy
--apollo	`boolean`	`false`	Creates an SSR React Apollo app with no deployment strategy