manucutillas / fastify-angular-universal

Angular Universal integration to Fastify for rendering Angular apps on the server

fastify-angular-universal

Angular server-side rendering support for Fastify using Angular Universal.

Install

npm install --save fastify-angular-universal

Usage

Add it to you project with register and pass the required options.

Follow the tutorial on how to perform SSR in Angular with Angular CLI here ONLY UNTIL step 3.

For the steps 4 and onwards use the following server.ts or check out the server.ts in the test-app directory

// These are important and needed before anything else
import 'zone.js/dist/zone-node';
import 'reflect-metadata';

import { join } from 'path';
import { readFileSync } from 'fs';

import { enableProdMode } from '@angular/core';
import * as fastify from 'fastify';

// * NOTE :: leave this as require() since this file is built Dynamically from webpack
const { AppServerModuleNgFactory, LAZY_MODULE_MAP } = require('./dist/server/main.bundle');
const { provideModuleMap } = require('@nguniversal/module-map-ngfactory-loader');

// Faster server renders w/ Prod mode (dev mode never needed)
enableProdMode();

const PORT = process.env.PORT || 3000;
const DIST_FOLDER = join(process.cwd(), 'dist');

// Our index.html we'll use as our template
const template = readFileSync(join(DIST_FOLDER, 'browser', 'index.html')).toString();

const app = fastify();

app.register(require('fastify-static'), {
  root: join(DIST_FOLDER, 'browser'),
  prefix: '/static/'
});

// register the fastify-angular-universal to your application together with the required options
app.register(require('fastify-angular-universal'), {
  serverModule: AppServerModuleNgFactory,
  document: template,
  extraProviders: [
    provideModuleMap(LAZY_MODULE_MAP)
  ]
});

// Declare a route
app.get('/*', function (request, reply) {
  // NOTE: you can also pass the options for the fastify-angular-universal fastify plugin 
  //       as second parameter to the `.renderNg()` function.
  // 
  //       Example: `reply.renderNg(url, options)`
  (reply as any).renderNg(request.req.url);
});

// Run the server!
app.listen(PORT, function (err) {
  if (err) {
    throw err;
  }

  console.log(`server listening on ${app.server.address().port}`);
});

Options

This plugin allow you to specify options:

• serverModule to specify the NgModuleFactory to be used in rendering an Angular app in the server
• document to specify the template where the Angular app will be rendered
• extraProviders to specify additional providers to be used by the Angular app. (optional)

License

MIT.