Tutorials & Guides

Step-by-step instructions to integrate, manage, and optimize your application configurations.

🔍
🚀
Beginner

Install & Initialize

Set up your first project, generate your API key, and load your initial config.json in under 5 minutes.

"npm": "@appconfig/core"
"init": "appconfig init"
⏱ 5 min read
Start Tutorial →
📦
Beginner

Node.js SDK Integration

Learn how to import the Node.js client, handle async config loading, and react to live updates.

import { AC } from '@appconfig/node';
const cfg = await AC.load();
⏱ 8 min read
Start Tutorial →
🌐
Intermediate

Multi-Environment Overrides

Master environment-specific configuration merging, conditional loading, and schema validation.

"env": { "prod": { "db": "cluster-01" } }
"merge": true
⏱ 12 min read
Start Tutorial →
🔐
Intermediate

Encrypting Secrets & Credentials

Securely store API keys, DB passwords, and tokens using our built-in KMS integration and field-level encryption.

"_encrypted": true
"cipher": "AES-256-GCM"
⏱ 10 min read
Start Tutorial →
⚡
Advanced

Real-Time Sync & WebSockets

Implement live configuration streaming, handle connection fallbacks, and manage subscription scopes.

AC.on('update', (patch) => { apply(patch); });
transport: "ws+tls"
⏱ 15 min read
Start Tutorial →
🐍
Beginner

Python & Django Integration

Configure settings.py dynamically, handle environment variables, and sync across worker processes.

from appconfig import Client
cfg = Client().get_env()
⏱ 9 min read
Start Tutorial →

💡 Quick Start Terminal

Copy-paste this into your terminal to scaffold a new config-managed project instantly.

# Create project directory
$ mkdir my-app && cd my-app

# Initialize App Config.json
$ npx @appconfig/cli init

✓ config.json generated
✓ .env template created
✓ Ready to deploy!

📋 Integration Checklist

  1. Install SDK

    Add the official package via npm, pip, or maven depending on your stack.

  2. Authenticate

    Set the `AC_API_KEY` environment variable or configure inline auth.

  3. Load & Validate

    Call the load method, apply your JSON schema, and handle missing fields.

  4. Enable Live Sync

    Subscribe to WebSocket events to receive updates without restarts.