1.0.6 • Published 6 months ago

componium v1.0.6

Weekly downloads
-
License
MIT
Repository
-
Last release
6 months ago

Componium - JavaScript full-stack framework

componium is a simple JavaScript full-stack framework

Getting Started

Install the framework

npm i -g componium

Create a new project

In a project directory, execute the following:

componium init

After the project is initialized, run componium dev to start the new app or componium create to scaffold!

Features

Server

  • File-based and dynamic URL handling
  • GraphQL API server support
  • Ability to start multiple servers within the same context
  • Event API integrated with API routes.

Docs

Initialization

To begin, you'll need to initialize a new Componium application.

const app = await Componium.initialize();

Server Configuration

app.createServer(options)

const server = await app.createServer({
  name: "package-service",
  routesRootDir: "routes",
  port: 9000,
  gql: true, // Indicates GraphQL is enabled
});

Options:

  • name: Name of the server.
  • routesRootDir: The directory containing route definitions.
  • port: The port on which the server will listen.
  • gql: A boolean value to indicate if GraphQL is enabled.

Middleware

server.addMiddleware(name, callback)

Parameters:

  • name: A unique name for the middleware.
  • callback: A function to be executed as middleware.

Routing

const router = server.createRouter(path);

Parameters:

  • path: The URL path for the route.
  • callback: A function handling the request-response for this route.

router.addMiddleware(name, callback)

Client Views

Client Views create front-end application endpoints to server HTML, CSS, and JavaScript.

server.addClientView(path, viewName, config)

Parameters:

  • path: The URL path where the view will be accessible.
  • viewName: The name of the view, presumably used to locate the view template or component.
  • config: A configuration object with view-specific options.

License

MIT