This project is a mix of ASP.NET Core Starter Kit and Microsoft ASP.NET Core React/Redux template.
I like original ASP.NET Core Starter Kit because it embraces Node.js and allows you to run on top of Kestrel web server but unfortunatelly it wasn't updated to support .NET Core SDK 2.1.
I like Microsoft ASP.NET Core React/Redux template but I don't like how it integrates with Node.js using node commands from inside .csproj file:
✓ It is less flexible than npm scripts and also is less familiar to front-end developers
✓ Node.js commands are embedded inside the .csproj project file which is great if you are just using Visual Studio to compile .NET Core but is quite annoying if you like to work with npm scripts and CLI.
This projects takes the best parts from ASP.NET Core Starter Kit and ASP.NET Core React/Redux template to create a new template levaraging the full power of Node.js and .NET Core 2.1 SDK with Kestrel as a web server. TypeScript was also added to the mix.
✓ Component-based front-end development via Webpack and React (see webpack.config.js)
✓ Static type checking with TypeScript
✓ Application state management via Redux
✓ Universal cross-stack routing and navigation history (see client/routes.tsx)
✓ Hot Module Replacement (HMR) /w React Hot Loader
✓ Lightweight build automation with plain JavaScript (see run.js)
✓ Cross-device testing with Browsersync
The project is framework agnostic so you can easily add your preferred styling framework.
Bootstrap 4 components
Ant design components
Material UI components
Or extend the loaders in webpack.config.js to compile your own SASS or LESS styles.
Another option instead of css could be to use css-in-js. Your can see a list of frameworks at MicheleBertoli's great repo here. Emotion has worked in a few test projects but feedback on a good library that plays well with typescript are appreciated.
- OS X, Windows or Linux
- Node.js v6 or newer
- .NET Core and .NET Core SDK
- Visual Studio Code or your prefered IDE.
Step 1. Clone the latest version of ASP.NET Core Starter Kit 2.0 on your local machine by running:
$ git clone -o aspnet-starter-kit -b master --single-branch \
https://github.com/Luteceo/aspnet-starter-kit-2.0 MyApp
$ cd MyAppStep 2. Install project dependencies listed in project.json and
package.json files:
$ npm install # Install both Node.js and .NET Core dependenciesor using Yarn:
$ yarn install # Install both Node.js and .NET Core dependenciesStep 3. Finally, launch your web app:
$ node run start # Compile and lanch the app, same as running: npm startThe app should become available at http://localhost:5000/.
See run.js for other available commands such as node run build etc.
You can also run your app in a release (production) mode by running node run --release, or without
Hot Module Replacement (HMR) by running node run --no-hmr.
TODO
You can always fetch and merge the latest changes from this (upstream) repo back into your project by running:
$ git checkout master
$ git fetch aspnet-starter-kit-2.0
$ git merge aspnet-starter-kit-2.0/master Anyone and everyone is welcome to contribute. The best way to start is by checking our open issues, submit a new issues or feature request, participate in discussions, upvote or downvote the issues you like or dislike, send pull requests.
Copyright © 2018-present Luteceo. This source code is licensed under the MIT
Made by Tomasz Jaskula @tjaskula
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent