runtime

README

Microcore Runtime

⚠️ Beta Version — Use With Caution

Microcore Runtime is currently in Beta. The runtime is functional and actively developed, but it has not yet reached production-ready maturity. During the Beta phase, APIs, behavior, configuration, and internal implementation may change between releases. Backward compatibility is not guaranteed, and breaking changes may be introduced as the runtime evolves. The Beta release is intended for development, evaluation, experimentation, and early integration. Production use is not recommended until a stable release is available.

Microcore Runtime is the shared execution layer for building resilient, observable, and secure service-based systems. It provides the common infrastructure every service needs — graceful lifecycle management, configuration, structured logging, telemetry, HTTP/gRPC transport, messaging, and database integration without forcing applications into a rigid framework. Instead of reimplementing infrastructure concerns in every service, Runtime provides a consistent operational contract across the platform, allowing services to focus on domain logic.

Features

• Lifecycle Management
  • Centralized graceful shutdown and application context cancellation
  • Coordinated dependency teardown on OS signals or explicit termination
• Configuration
  • Environment and file-based configuration
  • Support for strings, booleans, integers, durations, and binary values
  • Default values and predictable startup configuration
• Structured Logging
  • Go slog integration
  • Structured metadata and contextual logging
  • OpenTelemetry logging integration
• Observability
  • OpenTelemetry traces, metrics, and logs
  • OTLP exporters and Prometheus metrics
  • Context propagation across service boundaries
• HTTP & gRPC Transport
  • Server bootstrapping, routing, and middleware
  • CORS, TLS, Swagger/OpenAPI, profiling, and tracing support
  • gRPC infrastructure abstractions
• Messaging
  • Watermill-based messaging abstraction
  • Publishing and subscribing to message brokers
  • Message envelopes with metadata and content descriptors
  • Kafka, NATS, and Redis Streams integrations
• Database
  • GORM-based database integration
  • PostgreSQL support and migration helpers
  • Connection and lifecycle management
  • Reusable database adapter patterns

Documentation

https://microcore.dev/runtime

License

This project is licensed under the terms of the MIT License.

Copyright © 2026 Microcore