πŸš€ ONDEMANDENV

Taming Distributed System Complexity Through Application-Centric Infrastructure

[![Website](https://img.shields.io/badge/Website-ondemandenv.dev-blue)](https://ondemandenv.dev) [![Platform](https://img.shields.io/badge/Platform-AWS_CDK-orange)](https://aws.amazon.com/cdk/) [![License](https://img.shields.io/badge/License-MIT-green)](https://opensource.org/licenses/MIT) **Unlock true microservice agility. Free services from shared environments with isolated, on-demand lifecycles defined entirely by code.**

🌟 The Revolution

ONDEMANDENV transforms distributed system complexity into Application-Centric Infrastructure - enabling teams to manage their complete technology stack as a single, cohesive unit through Unified Cloud Stacks.

⚑ The Magic: Branch = Environment

# Create complete isolated environment for any feature
git commit -m "feature: new payment API

odmd: create@dev"

# Platform automatically provisions:
# βœ… AWS resources (S3, RDS, IAM roles)
# βœ… Kubernetes workloads and services  
# βœ… Cross-account network connectivity
# βœ… Security policies and monitoring
# βœ… Complete application stack

πŸ”„ Traditional vs ONDEMANDENV

Traditional Chaos ONDEMANDENV Excellence
πŸ”€ Tool Sprawl: CloudFormation + K8s + Terraform πŸ”§ Unified CDK: Single tool for everything
🀝 Shared Bottlenecks: dev/qa/prod conflicts ⚑ Isolated Environments: Branch-specific stacks
πŸ“œ YAML Hell: Manual configuration drift πŸ’» Code-Driven: TypeScript with IntelliSense
πŸ€” Hidden Coupling: Implicit dependencies πŸ“‹ Explicit Contracts: Clear service boundaries

πŸ—οΈ Architecture Ecosystem

ONDEMANDENV Architecture

🎯 Three-Layer Innovation

πŸ“‹ ContractsLib - Architecture as Code

Central β€œCongress” where teams negotiate service boundaries through code contracts

πŸ›οΈ Platform Services - Shared Infrastructure

Enterprise-grade services (Networking, EKS, Databases) consumed without operational burden

πŸš€ Applications - Unified Cloud Stacks

Real apps demonstrating AWS + Kubernetes unified in single codebases


πŸš€ Repository Ecosystem

πŸ›οΈ Foundation

🌐 Platform Services

πŸ“± Application Examples

πŸ“š Documentation


🎯 Core Innovation: Unified Cloud Stacks

Before: Fragmented Nightmare 😞

# infrastructure.yaml (CloudFormation)
Resources:
  MyBucket: { Type: AWS::S3::Bucket }

# app.yaml (Kubernetes) 
apiVersion: apps/v1
kind: Deployment
# ... manual secrets management ...

After: Unified Excellence πŸš€

// Single CDK stack = Complete application
export class MyAppStack extends cdk.Stack {
  constructor() {
    // AWS Resources
    const bucket = new Bucket(this, 'AppBucket');
    const podRole = new Role(this, 'PodRole', {/* IRSA */});
    
    // Kubernetes Resources (cdk8s)
    const chart = new cdk8s.Chart(app, 'AppChart');
    new Deployment(chart, 'App', {
      containers: [{ 
        image: myImage,
        envVariables: { BUCKET_ARN: {value: bucket.bucketArn} }
      }],
      serviceAccount: { 
        annotations: {'eks.amazonaws.com/role-arn': podRole.roleArn} 
      }
    });
    
    // Platform deploys automatically
    new EksManifest(this, 'deploy', { manifest: chart });
  }
}

⚑ Quick Start Journey

1. πŸŽ“ Learn the Philosophy

open https://ondemandenv.dev/concepts.html

2. πŸ” Study the Architecture

git clone https://github.com/ondemandenv/odmd-contracts-sandbox

3. πŸ—οΈ Deploy Platform

git clone https://github.com/ondemandenv/networking
cd networking && npx cdk deploy

4. πŸš€ Experience Unified Stacks

git clone https://github.com/ondemandenv/spring-boot-swagger-3-example
cd spring-boot-swagger-3-example/cdk && npx cdk synth

🌟 Transformational Impact

πŸ“ˆ Proven Results

🎯 For Every Team

🏒 Organizations: Faster time-to-market, enhanced security, better governance
πŸ‘¨β€πŸ’» Developers: Focus on business logic, instant environments, unified toolchain
πŸ› οΈ Platform Teams: Clear boundaries, explicit contracts, automated operations


🀝 Join the Revolution

🌐 Community

πŸš€ Business Opportunities

🀝 Contributing

Every repository welcomes contributions:

  1. 🍴 Fork and explore
  2. 🌿 Create feature branches
  3. βœ… Test thoroughly
  4. πŸ“ Submit pull requests

## πŸš€ Ready to Transform Your Infrastructure? **[πŸ“– Explore Docs](https://ondemandenv.dev)** β€’ **[πŸš€ Try Platform](https://github.com/ondemandenv/odmd-contracts-sandbox)** β€’ **[πŸ’¬ Get Support](mailto:contacts@ondemandenv.dev)** **🌟 Star our repositories β€’ 🍴 Fork and contribute β€’ πŸ“’ Spread the word**