fuse-box
diff --git a/‎docs/development/dev-server.md
Lines changed: 11 additions & 0 deletions b/‎docs/development/dev-server.md
Lines changed: 11 additions & 0 deletions
diff --git a/‎src/devServer/HTTPServer.ts
Lines changed: 8 additions & 0 deletions b/‎src/devServer/HTTPServer.ts
Lines changed: 8 additions & 0 deletions
diff --git a/‎src/devServer/Server.ts
Lines changed: 6 additions & 1 deletion b/‎src/devServer/Server.ts
Lines changed: 6 additions & 1 deletion
diff --git a/‎src/tests/BundleApi.test.ts
Lines changed: 6 additions & 0 deletions b/‎src/tests/BundleApi.test.ts
Lines changed: 6 additions & 0 deletions
@@ -31,6 +31,17 @@ fuse.dev({
 })
 ```
 
+## Fallback
+
+If you develop a SPA app you can set a fallback. All 404's will return the fallback file you specify. The file path is relative to your served root.
+
+```js
+fuse.dev({
+    root: 'public/build',
+    fallback: 'index.html'
+})
+```
+
 ## Port
 By default you will get `express` application running and a `socket` server (if [HMR](#hot-module-reload) is enabled) bound to port `4444`. To change the port provide `port` option.
 
 
@@ -12,6 +12,9 @@ export interface HTTPServerOptions {
     /** Provide https server options to enable https */
     https?: https.ServerOptions;
 
+    /** 404 fallback */
+    fallback?: string;
+
     /**
      * If specfied this is the folder served from express.static
      * It can be an absolute path or relative to `appRootPath`
@@ -101,5 +104,10 @@ Development server running ${opts.https ? 'https' : 'http'}://localhost:${port}
                 this.app.use(this.fuse.context.sourceMapsRoot, express.static(this.fuse.context.homeDir));
             }
         }
+        if (this.opts.fallback) {
+            this.app.use('*', (req, res) => {
+                res.sendFile(this.opts.fallback)
+            })
+        }
     }
 }
@@ -5,6 +5,7 @@ import { FuseBox } from "../core/FuseBox";
 import { utils } from "realm-utils";
 import * as process from "process";
 import * as https from 'https';
+import * as path from 'path';
 
 export type HotReloadEmitter = (server: Server, sourceChangedInfo: any) => any;
 
@@ -22,6 +23,9 @@ export interface ServerOptions {
     /** If not specified it uses regular http */
     https?: https.ServerOptions;
 
+    /** 404 fallback */
+    fallback?: string;
+
     /**
      * - If false nothing is served.
      * - If string specified this is the folder served from express.static
@@ -67,6 +71,7 @@ export class Server {
             ? (utils.isString(opts.root) ? ensureUserPath(opts.root as string) : false) : rootDir;
         const port = opts.port || 4444;
         const https = opts.https
+        const fallback = root && opts.fallback && path.join(root, opts.fallback)
         if (opts.hmr !== false && this.fuse.context.useCache === true) {
 
             setTimeout(() => {
@@ -85,7 +90,7 @@ export class Server {
             if (opts.httpServer === false) {
                 this.socketServer = SocketServer.startSocketServer(port, this.fuse);
             } else {
-                this.socketServer = this.httpServer.launch({ root, port, https }, opts);
+                this.socketServer = this.httpServer.launch({ root, port, https, fallback }, opts);
             }
         });
         return this;
 
@@ -111,6 +111,12 @@ export class BundleApiTest {
         should(fuse.producer.devServerOptions).deepEqual({ port: 4444, https: { cert: "cert", key: "key" } })
     }
 
+    "Should setup devServer with fallback param"() {
+        const fuse = createFuse();
+        fuse.dev({ fallback: "index.html" });
+        should(fuse.producer.devServerOptions).deepEqual({ port: 4444, fallback: "index.html" })
+    }
+
     "Should inject 1 plugin"() {
         const fuse = createFuse();
         const bundle = fuse.bundle("app").plugin("first");
Original file line number	Diff line number	Diff line change
`@@ -12,6 +12,9 @@ export interface HTTPServerOptions {`
`12`	`12`	`/** Provide https server options to enable https */`
`13`	`13`	`https?: https.ServerOptions;`
`14`	`14`
	`15`	`+ /** 404 fallback */`
	`16`	`+ fallback?: string;`
	`17`	`+`
`15`	`18`	`/**`
`16`	`19`	`* If specfied this is the folder served from express.static`
`17`	`20`	* It can be an absolute path or relative to `appRootPath`
`@@ -101,5 +104,10 @@ Development server running ${opts.https ? 'https' : 'http'}://localhost:${port}`
`101`	`104`	`this.app.use(this.fuse.context.sourceMapsRoot, express.static(this.fuse.context.homeDir));`
`102`	`105`	`}`
`103`	`106`	`}`
	`107`	`+ if (this.opts.fallback) {`
	`108`	`+ this.app.use('*', (req, res) => {`
	`109`	`+ res.sendFile(this.opts.fallback)`
	`110`	`+ })`
	`111`	`+ }`
`104`	`112`	`}`
`105`	`113`	`}`