Service Configuration Apps

When this skill applies

Use this skill when a VTEX IO service should receive structured configuration from another app through the configuration builder instead of relying only on local app settings.

• Creating a configuration app with the configuration builder
• Exposing configuration entrypoints from a service app
• Sharing one configuration contract across multiple services or apps
• Separating configuration lifecycle from runtime app lifecycle
• Reading injected configuration through ctx.vtex.settings

Do not use this skill for:

• simple app-local configuration managed only through settingsSchema
• Store Framework block settings through contentSchemas.json
• generic service runtime wiring unrelated to configuration
• policy design beyond the configuration-specific permissions required

Decision rules