Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/queses/next-inferno
NextJS plugin for blazing fast Inferno-powered rendering
https://github.com/queses/next-inferno
Last synced: about 2 months ago
JSON representation
NextJS plugin for blazing fast Inferno-powered rendering
- Host: GitHub
- URL: https://github.com/queses/next-inferno
- Owner: queses
- Created: 2018-03-18T20:12:59.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2018-03-21T13:51:48.000Z (over 6 years ago)
- Last Synced: 2024-05-10T16:32:30.157Z (5 months ago)
- Language: JavaScript
- Size: 5.86 KB
- Stars: 10
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
- awesome-blazingly-fast - next-inferno - NextJS plugin for blazing fast Inferno-powered rendering (JavaScript)
README
# Next.js + Inferno
Use [Inferno](https://infernojs.org) :fire: with [Next.js](https://github.com/zeit/next.js) to get even faster :zap: rendering.
## Installation
```
npm install --save next-inferno inferno inferno-compat inferno-clone-vnode inferno-create-class inferno-create-element
```
or
```
yarn add next-inferno inferno inferno-compat inferno-clone-vnode inferno-create-class inferno-create-element
```
## Usage
Create a `next.config.js` in your project
```js
// next.config.js
const withInferno = require('next-inferno')
module.exports = withInferno()
```
Then create a `server.js`
```js
// server.js
require('next-inferno/alias')()
const { createServer } = require('http')
const next = require('next')
const app = next({ dev: process.env.NODE_ENV !== 'production' })
const handle = app.getRequestHandler()
const port = process.env.PORT || 3000
app.prepare()
.then(() => {
createServer(handle)
.listen(port, () => {
console.log(`> Ready on http://localhost:${port}`)
})
})
```
Then add or change "scripts" section of your `package.json`:
```json
...
"scripts": {
"dev": "node server.js",
"build": "next build",
"start": "NODE_ENV=production node server.js"
},
...
```
Optionally you can add your custom Next.js configuration as parameter
```js
// next.config.js
const withInferno = require('next-inferno')
module.exports = withInferno({
webpack(config, options) {
return config
}
})
```
## TypeScript support
Looking for [TypeScript](http://www.typescriptlang.org/) support? Just follow that easy steps to use it in your Next projects:
1. Install `typescript` and `@zeit/next-typescript`:
```
npm install --save typescript @zeit/next-typescript
```
or
```
yarn add typescript @zeit/next-typescript
```
2. Edit `next.config.js`:
```js
// next.config.js
const withInferno = require('next-inferno')
const withTypescript = require('@zeit/next-typescript')
module.exports = withInferno(withTypescript())
```
3. Create 'tsconfig.json' file:
```json
{
"compileOnSave": false,
"compilerOptions": {
"target": "esnext",
"module": "esnext",
"jsx": "preserve",
"allowSyntheticDefaultImports": true,
"allowJs": true,
"moduleResolution": "node",
"sourceMap": true,
"removeComments": false,
"baseUrl": ".",
"lib": [
"dom",
"es2015",
"es2016"
]
}
}
```
4. Write code :fire:
### Check on compile
By default, next's TypeScript plugin only transpiles your code without type checks. It means that you can see type errors only in your IDE or code editor (for example VS Code can do it out of the box).
If you want to enable typechecks on compile to see type errors in terminal or browser, make the following changes in 'next.config.js':
```js
// next.config.js
const withInferno = require('next-inferno')
const withTypescript = require('@zeit/next-typescript')
module.exports = withInferno(withTypescript({
webpack(config, options) {
return config
},
typescriptLoaderOptions: {
transpileOnly: false
}
}))
```
Alternatively to decrease compile time you can use [`fork-ts-checker-webpack-plugin`](https://github.com/Realytics/fork-ts-checker-webpack-plugin) to fork type checks in a separate process:
```js
// next.config.js
const withInferno = require("next-inferno")
const withTypescript = require("@zeit/next-typescript")
var ForkTsCheckerWebpackPlugin = require('fork-ts-checker-webpack-plugin');
module.exports = withInferno(withTypescript({
webpack(config, options) {
if (options.isServer) config.plugins.push(new ForkTsCheckerWebpackPlugin())
return config
}
}))
```