appconfig-system

What problem does it solve?

Managing application configuration, especially in a Next.js app deployed to Kubernetes, can lead to hydration issues, lack of type safety, and complex deployment workflows. This skill provides expert guidance on the AppConfig system, offering a robust, type-safe, and Kubernetes-friendly solution for runtime configuration.

Core Features & Use Cases

• Unified Config Management: Explains server-side loadAppConfig(), client-side useAppConfig(), and MDX content loading, ensuring consistent configuration access.
• Kubernetes & Sentry Integration: Details how to use ConfigMaps for deployment and inject Sentry configuration, simplifying operations and error tracking.
• Type-Safe & Validated: Emphasizes JSON schema validation and full TypeScript support, preventing configuration errors.
• Use Case: When deploying a new feature that requires environment-specific URLs and feature flags, use this skill to define them in squareone.config.yaml, load them via getServerSideProps, and access them in components using useAppConfig().

Quick Start

Load the application configuration on the server-side for a Next.js page. import { loadAppConfig } from '../lib/config/loader'; const appConfig = await loadAppConfig();