|
1 |
| -<img src="http://qwebdev.ro/media/rbb/thumb.png" data-canonical-src="http://qwebdev.ro/media/rbb/thumb.png" width="100%" /> |
2 |
| -A ready to go React js boilerplate, backed by latest techs and tools to get your React projects on feet in no time. The boilerplate includes basic API call example and UI elements usage example. |
| 1 | +## About |
3 | 2 |
|
4 |
| -### Getting started |
5 |
| -You can also check out the official page of the boilerplate [Here](https://rbb.qdev.tech). |
| 3 | +A ready-to-go, production ready React.js boilerplate, backed by reliant technologies and tools to get your React projects up and running in no time. The boilerplate includes basic examples of API calls and UI elements usage. |
6 | 4 |
|
7 |
| -#### Installation and development mode |
| 5 | +--- |
| 6 | + |
| 7 | +##### 2024 Update |
| 8 | + |
| 9 | +While researching different frameworks and tools to assist with building new SPAs, I realized that this older boilerplate had some neat development and production tools that facilitate fast development. |
| 10 | + |
| 11 | +All deprecated libraries have been updated, and those no longer supported have been replaced with alternatives that offer long-term support. |
| 12 | + |
| 13 | +Compatibility with the latest versions of Node.js, npm, and operating systems has also been improved. |
| 14 | + |
| 15 | +## Getting Started |
| 16 | + |
| 17 | +You can also check out the official page of the boilerplate [here](https://rbb.qdev.tech). |
| 18 | + |
| 19 | +#### Installation and Development Mode |
8 | 20 |
|
9 | 21 | * `git clone https://github.com/theqdev/react-big-bang`
|
10 | 22 | * `npm run setup` or `npm install`
|
11 | 23 | * `npm start`
|
12 | 24 |
|
| 25 | +### Creating a Production Build |
13 | 26 |
|
14 |
| -#### Creating production build |
15 |
| - |
16 |
| -* `npm run clean-dist` _Cleans build directory_ |
17 |
| -* `npm run prebuild` _Cleans build directory and runs Lint plus Tests_ |
18 |
| -* `npm run build` _Generates production build_ |
19 |
| -* `npm run analyze-bundle` _Analyze bundle size and it's libraries_ |
| 27 | +* `npm run clean-dist` - _Cleans the build directory_ |
| 28 | +* `npm run prebuild` - _Cleans the build directory and runs linting and tests_ |
| 29 | +* `npm run build` - _Generates the production build_ |
| 30 | +* `npm run analyze-bundle` - _Analyzes bundle size and its libraries_ |
20 | 31 |
|
| 32 | +### Linting and Tests |
21 | 33 |
|
22 |
| -#### Linting and Tests |
23 |
| -* `npm lint` or `npm lint:watch` |
| 34 | +* `npm run lint` or `npm run lint:watch` |
24 | 35 | * `npm run test`
|
25 | 36 |
|
26 |
| -### Technologies |
27 |
| - |
28 |
| -Slingshot offers a rich development experience using the following technologies: |
29 |
| - |
30 |
| -| **Tech** | **Description** | |
31 |
| -|----------|------- |
32 |
| -| [React](https://facebook.github.io/react/) | Fast, composable client-side components. | |
33 |
| -| [Redux](http://redux.js.org) - [Redux Sauce](https://github.com/infinitered/reduxsauce) - [Redux Saga](https://github.com/redux-saga/redux-saga) | Clean and modern implementation of Redux. Enforces unidirectional data flows and immutable, hot reloadable store that supports time-travel debugging. | |
34 |
| -| [react-bootstrap](https://react-bootstrap.github.io/) | React Bootstrap UI kit for React Js. | |
35 |
| -| [APISauce](https://github.com/infinitered/apisauce) | Axios Based API wrapper for mapping your app's backend. | |
36 |
| -| [React Router](https://github.com/reactjs/react-router) | A complete routing library for React | |
37 |
| -| [Babel](http://babeljs.io) | Compiles ES6 to ES5. Enjoy the new version of JavaScript today. | |
38 |
| -| [Webpack](https://webpack.js.org) | Bundles npm packages and our JS into a single file. Includes hot reloading via [react-transform-hmr](https://www.npmjs.com/package/react-transform-hmr). | |
39 |
| -| [Browsersync](https://www.browsersync.io/) | Lightweight development HTTP server that supports synchronized testing and debugging on multiple devices. | |
40 |
| -| [Jest](https://facebook.github.io/jest/) | Automated tests with built-in expect assertions and [Enzyme](https://github.com/airbnb/enzyme) for DOM testing without a browser using Node. | |
41 |
| -| [TrackJS](https://trackjs.com/) | JavaScript error tracking. | |
42 |
| -| [ESLint](http://eslint.org/)| Lint JS. Reports syntax and style issues. Using [eslint-plugin-react](https://github.com/yannickcr/eslint-plugin-react) for additional React specific linting rules. | |
43 |
| -| [SASS](http://sass-lang.com/) | Compiled CSS styles with variables, functions, and more. || |
44 |
| -| [PostCSS](https://github.com/postcss/postcss) | Transform styles with JS plugins. Used to autoprefix CSS | |
45 |
| -| [Editor Config](http://editorconfig.org) | Enforce consistent editor settings (spaces vs tabs, etc). |) |
46 |
| -| [npm Scripts](https://docs.npmjs.com/misc/scripts)| Glues all this together in a handy automated build. | |
| 37 | +## Technologies |
| 38 | + |
| 39 | +Under the hood, the kit is powered by: |
| 40 | + |
| 41 | +| **Tech** | **Description** | |
| 42 | +|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------| |
| 43 | +| [React](https://facebook.github.io/react/) | Fast, composable client-side components. | |
| 44 | +| [react-bootstrap](https://react-bootstrap.github.io/) | React Bootstrap UI kit for React.js. | |
| 45 | +| [Redux](http://redux.js.org) - [Redux Sauce](https://github.com/infinitered/reduxsauce) - [Redux Saga](https://github.com/redux-saga/redux-saga) | Redux store implementation. Enforces unidirectional data flows and an immutable, hot-reloadable store that supports time-travel debugging. | |
| 46 | +| [APISauce](https://github.com/infinitered/apisauce) | Axios-based API wrapper for mapping your app's backend. | |
| 47 | +| [React Router](https://github.com/reactjs/react-router) | A complete routing library for React. | |
| 48 | +| [Babel](http://babeljs.io) | Compiles code to any desired presets. | |
| 49 | +| [Webpack](https://webpack.js.org) | Bundles npm packages and our JS into a single file. Includes hot reloading. | |
| 50 | +| [Browsersync](https://www.browsersync.io/) | Lightweight development HTTP server that supports synchronized testing and debugging on multiple devices. | |
| 51 | +| [Jest](https://facebook.github.io/jest/) | Automated tests with built-in expect assertions and react-testing-library for DOM testing without a browser using Node. | |
| 52 | +| [TrackJS](https://trackjs.com/) | JavaScript error tracking. | |
| 53 | +| [ESLint](http://eslint.org/) | Lint JS. Reports syntax and style issues. Using [eslint-plugin-react](https://github.com/yannickcr/eslint-plugin-react) for additional React-specific linting rules. | |
| 54 | +| [SASS](http://sass-lang.com/) | Compiled CSS styles with variables, functions, and more. | |
| 55 | +| [PostCSS](https://github.com/postcss/postcss) | Transforms styles with JS plugins. Used to autoprefix CSS. | |
| 56 | +| [EditorConfig](http://editorconfig.org) | Enforces consistent editor settings (spaces vs tabs, etc). | |
| 57 | +| [npm Scripts](https://docs.npmjs.com/misc/scripts) | Glues all this together in a handy automated build. | |
| 58 | + |
| 59 | +## Contributing |
47 | 60 |
|
| 61 | +If you ever end up using this and find a fix or an improvement, don't hesitate to open a [PR of your changes](https://docs.github.com/en/get-started/exploring-projects-on-github/contributing-to-a-project). |
48 | 62 |
|
49 | 63 | ---
|
50 | 64 |
|
51 |
| -Check out our website at [Qdev](https://qdev.tech) and our code marketplace at [Alkanyx](https://alkanyx.com) for more cool stuff. |
| 65 | +Check out our website at [Qdev](https://qdev.tech) and our other projects at [Envato Market](https://codecanyon.net/user/ic0de) for more cool stuff. |
0 commit comments