Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ioanungurean/forge-react-app
Start building React apps using TypeScript or ECMAScript
https://github.com/ioanungurean/forge-react-app
react typescript webpack webpack5
Last synced: about 2 months ago
JSON representation
Start building React apps using TypeScript or ECMAScript
- Host: GitHub
- URL: https://github.com/ioanungurean/forge-react-app
- Owner: ioanungurean
- License: mit
- Created: 2017-09-20T20:36:08.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2023-10-03T08:33:24.000Z (12 months ago)
- Last Synced: 2024-07-11T13:54:59.307Z (2 months ago)
- Topics: react, typescript, webpack, webpack5
- Language: JavaScript
- Homepage: https://npmjs.com/package/forge-react-app
- Size: 5.87 MB
- Stars: 96
- Watchers: 4
- Forks: 4
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Forge React App 
Create React apps with no build configuration. (TypeScript or ECMAScript)
- [Creating an App](#creating-an-app) – How to create a new app.
Forge React App works on macOS, Windows, and Linux.
If something doesn’t work, please [file an issue](https://github.com/ioanungurean/forge-react-app/issues/new).
## Quick Overview
```sh
npx forge-react-app@latest my-app
cd my-app
npm start
```
Then open [http://localhost:9000/](http://localhost:9000/) to see your app.
When you’re ready to deploy to production, create a minified bundle with `npm run build`.
### Get Started Immediately
You **don’t** need to install or configure tools like Webpack or Babel.
They are preconfigured so that you can focus on the code.
Just create a project, and you’re good to go.
## Creating an App
**You’ll need to have Node 14 or later on your local development machine** (but it’s not required on the server). You can use [nvm](https://github.com/creationix/nvm#installation) (macOS/Linux) or [nvm-windows](https://github.com/coreybutler/nvm-windows#node-version-manager-nvm-for-windows) to easily switch Node versions between different projects.
To create a new app, you may choose one of the following methods:
### npx
```sh
npx forge-react-app@latest my-app
```
### npm
```sh
npm i -g forge-react-app
forge-react-app my-app
```
It will create a directory called `my-app` inside the current folder.
Inside that directory, it will generate the initial project structure and install the transitive dependencies.
```
my-app
│ .babelrc
│ .gitignore
│ package.json
│
├───devtools
│ webpack.common.js
│ webpack.dev.js
│ webpack.prod.js
│ setUpTests.js
│
└───src
│ index.js
│ index.html
│ App.js
│
├───styles
│ StyledApp.js
│
└───__tests__
App.test.js
```
No configuration or complicated folder structures, just the files you need to build your app.
Once the installation is done, you can open your project folder:
```sh
cd my-app
```
Inside the newly created project, you can run some built-in commands:
### `npm start` or `yarn start`
Runs the app in development mode.
Open [http://localhost:9000](http://localhost:9000) to view it in the browser.
The page will automatically reload if you make changes to the code.
You will see the build errors and lint warnings in the console.
### `npm test` or `yarn test`
Runs the test watcher in an interactive mode.
### `npm run build` or `yarn build`
Builds the app for production to the `dist` folder.
It correctly bundles React in production mode and optimizes the build for the best performance.
The build is minified and the filenames include the hashes.
Your app is ready to be deployed.
## Main dependencies
| Package | Version | Details |
| ---------------------- |---------|----------------------------|
| React | ^18 | |
| TypeScript | ^4 | for the TypeScript version |
| Jest | ^29 | |
| Testing Library | ^13 | |
| Babel | ^7 | |
| Webpack | ^5 | |
## Feedback and suggestions
If you want to leave some suggestions or give me constructive feedback please don't hesitate to [file an issue](https://github.com/ioanungurean/forge-react-app/issues/new).
## License
Forge React App is open source software [licensed as MIT](https://github.com/ioanungurean/forge-react-app/blob/master/LICENSE.md).