Table of Contents

Getting started: your first SquidStd host

Build a minimal SquidStd application: a bootstrapper that loads config, configures logging, and runs the registered services until shutdown.

What you'll build

A console host on top of SquidStdBootstrap (from SquidStd.Services.Core, which brings in SquidStd.Core and SquidStd.Abstractions). It loads its config, wires the default services, and runs until you stop it.

Prerequisites

  • .NET 10 SDK
  • dotnet add package SquidStd.Services.Core

Steps

1. Create the bootstrapper

SquidStdBootstrap.Create takes a SquidStdOptions (config name + root directory) and registers the core services (config, logging, event bus, jobs, timers…) into an owned DryIoc container.


var bootstrap = SquidStdBootstrap.Create(
    new SquidStdOptions
    {
        ConfigName = "squidstd",
        RootDirectory = AppContext.BaseDirectory
    }
);

2. Start the services

StartAsync starts every registered ISquidStdService in priority order.


await bootstrap.StartAsync();

3. Run until shutdown

RunAsync starts (if not already started), waits for cancellation, then stops the services cleanly. Use either StartAsync plus your own loop, or just RunAsync.


await bootstrap.RunAsync();

Run it

dotnet run --project samples/SquidStd.Samples.GettingStarted

The host starts, logs the service lifecycle, and waits until you press Ctrl+C.

How it works

SquidStdBootstrap is the composition root: it builds the container, registers the core services, loads the config sections, and orchestrates the ISquidStdService lifecycle. Every other SquidStd module plugs into this container through its Add… extension methods.

See also

Edit this page