This project includes a working example of React, React Router, and TypeScript.
All the code is in TypeScript, written as either .ts or .tsx files.
The gulp-based build generates a browserified client file which is separate from the vendor file.
The vendor file currently includes react and react-router.
This separation speeds up the build process and can result in fewer client downloads when new builds are released.
The gulp build process works with gulp.watch.
This is a basic starter project with a minimal number of views and components. Many recent React examples are written in ES6 and make use of Babel. These are largely compatible with this TypeScript based process.
This starter also includes an example of how to use Redux with TypeScript. In order to keep the starter as clean as possible, the Redux example is on a branch.
- React with React Router
- Redux (on a separate branch)
- TypeScript TSX
- Isomorphic between server and client
- Client app.js is browserified
- Client vendor.js is browserified separately
- Browserify-shim supports external scripts
- Gulp based build with watch tasks
This template supports the following versions for key dependencies:
- React 16.8
- React Router 5.0
- Redux 4.0 (redux branch)
- TypeScript 3.4
You'll need a few frameworks and utilities to be installed before starting.
You'll need the following prior to setup:
This will get all the packages required for development and run time,
as defined in the package.json file.
> npm install
To run a full build, just run gulp with no arguments.
> gulp
You can also use npm.
> npm run build
Run watch and keep the console open.
> gulp watch
Gulp will automatically rebuild when a source file or CSS file changes.
Run this command:
> npm run dev
Then open a browser and navigate to http://localhost:3000 to view.
You can also run the server with automatic reloading using nodemon and BrowserSync.
> gulp serve
This will launch at a different port since it proxies Express.
A simple starter project can be found at react-tsx-lite.
BSD (the same as React)