@glowing-fishstick/app

Core application factory and configuration module for the glowing-fishstick framework.

Overview

This package provides the main application factory, server factory, configuration utilities, and error handling for building composable Express.js applications. It is designed to be consumed as an npm module by downstream apps.

Features

• Factory functions for creating Express apps and HTTP servers
• Plugin contract for custom routes, middleware, and views
• Built-in health, admin, and landing routes
• Configuration management with environment variable support
• Graceful shutdown for container environments
• Functional programming patterns for testability and composability

Usage

Install via npm (when published):

npm install @glowing-fishstick/app

Import and compose your app.

Recommended (explicit) imports:

import { createApp, createConfig } from '@glowing-fishstick/app';
import { createServer } from '@glowing-fishstick/shared';
import { myPlugin } from './my-plugin.js';

const config = createConfig({ appName: 'my-app' });
const app = createApp(config, [myPlugin]);
const { server, close } = createServer(app, config);

Note: createServer is implemented in @glowing-fishstick/shared and is re-exported by @glowing-fishstick/app for convenience; either import path is acceptable depending on how you want to reference the server factory.

API Reference

See the main glowing-fishstick documentation for full API details.

License

MIT