createApp()

The main factory function. Creates and configures a SpaceNode application with auto-discovery.

import { createApp } from 'SpaceNode'

const app = await createApp(config)

Configuration Options

Examples

Minimal

const app = await createApp()
app.listen(3000)

With Database

import mongoose from 'mongoose'
await mongoose.connect('mongodb://localhost/mydb')

const app = await createApp({
  db: mongoose.connection,
  debug: true,
})
app.listen(3000)

With Static Files (SPA)

const app = await createApp({
  static: './public',     // serve static files
  // spa: true,            // SPA fallback (on by default)
})
app.listen(4000)

With Global Pipes

const app = await createApp({
  pipe: ['cors', 'logger', 'rateLimit:100'],  // every route gets these
})
app.listen(3000)

org Mode (Watch)

const app = await createApp({
  watch: true,  // auto-restart on file changes (like nodemon)
})
app.listen(3000)

When watch: true, SpaceNode spawns the server as a child process and watches the working directory for file changes. On any change, it restarts the server automatically. node_modules/ and .git/ are ignored. Zero performance overhead — the watcher runs in a separate process.

App Properties

After creation, the app instance exposes these read-only properties:

App Methods

Path Resolution

All relative paths in config (modulesDir, static) are resolved from the entry script's directory (process.argv[1] — the file you run with node app.js). This works out of the box for local development:

// Just works — paths resolve from the file you run with `node app.js`
const app = await createApp()
app.listen(3000)

Serverless & Production

On serverless platforms (Vercel, AWS Lambda) and in test runners, process.argv[1] points to the platform's bootstrap runtime — not your file. Use baseUrl to resolve paths reliably:

const app = await createApp({
  baseUrl: import.meta.url,  // resolve paths from this file, not process.argv[1]
})

export default (req, res) => app.handle(req, res)