Create CIVA App - The DOT Stack Scaffolding Tool "The future is not coded, but grown." create-civa-app is the official command-line tool for the DOT (Digit Organized Transmission) Stack, a revolutionary full-stack architecture for building resilient, emergent applications based on the patented CIVA Emergent Framework.

🤯 The Problem: Why Traditional Software Fails For 70 years, we've built software on a brittle foundation of if/else logic. This leads to a nightmare called State-Space Explosion.

Every if statement in your code doubles the number of possible states your application can be in. A simple system with just 20 ifs has over 1 million possible paths. A complex application has billions. It is mathematically impossible to test them all. This is why software is fragile, unpredictable, and why bugs appear in production that you can never find in testing.

The Old Way: A Brittle House of Cards

// A simple decision becomes a tangled mess that is impossible to maintain. if (health < 25) { if (isUnderFire) { if (hasCover) { // ... what if we add an "is_bleeding" state? // You'd have to rewrite this entire block. } else { // ... } } } else if (ammo > 50) { // ... another nested mess }

✨ The Solution: The CIVA Emergent Framework The CIVA Framework solves this by changing the paradigm. Instead of chasing billions of states, it collapses the entire system's state into a single, holistic "gut feeling" called a Valence Score. Actions are no longer complex logical branches, but simple, instantaneous reflexes based on where that score falls on a spectrum.

The CIVA Way: Resilient & Scalable Reflex

Imagine your AI's "brain" as a simple, flat spectrum:

  ▲ Valence Score (A single number representing the entire state)
  │

-200 │ -100 │ 0 │ 100 │ 200 ◄─────────┼─────────────────┼───────────────────┼──────────────────┼──────────► │ │ │ │ [ FLEE ] [ TAKE COVER ] [ PATROL ] [ ADVANCE ]

This architecture is profoundly superior. To add a new state—like "on fire"—you don't rewrite the decision tree. You simply add one line to the valence calculation: if (state.isOnFire) valence -= 50;. The AI's behavior emergently adapts. It becomes more likely to "TAKE COVER" or "FLEE" without you ever explicitly coding that connection.

🚀 Getting Started in 60 Seconds Get your first living application running instantly.

npx create-civa-app my-living-app

This creates a new directory called my-living-app with a fully configured and working DOT Stack project.

Then, just run:

cd my-living-app npm install npm run dev

Your new emergent application is now alive and running at http://localhost:3000.

🏛️ What's Inside the Generated Project? The create-civa-app tool scaffolds a complete project with everything you need:

/civa-js/: The core frontend library. This is the heart of the framework.

/backend/: A ready-to-use Node.js Express server that acts as the "Transmission Layer".

/docs/: Detailed documentation and examples to get you building.

index.html, app.js, style.css: A beautiful, working example to start from.

Key Concepts of CIVA.js Soul.js: The central consciousness. Its _update() loop is the "heartbeat" of your application.

Substrate.js: The "emotional canvas." A raw mathematical signature of the system's current state—its digital "gut feeling."

Sensor.js: The "awareness." Sensors watch the Substrate for changes, calculate the overall Valence Score, and trigger reflexes.

Digit.js: The "nervous system." Handles all communication with the backend Transmission Layer.

💡 What Can You Build with the DOT Stack? This framework is designed for any system that needs to make complex decisions in a dynamic environment.

Next-Generation Game AI: Create enemies and NPCs that feel truly alive and react organically to a chaotic world, without writing thousands of lines of if/else logic.

Real-Time Anomaly Detection: Build ultra-fast systems for cybersecurity or financial trading that can detect the "feeling" of an attack or a market crash in nanoseconds.

Advanced Robotics & IoT: Develop robots that can emergently adapt to changing terrain or factory floor conditions.

Complex UIs & State Management: Build user interfaces that react holistically to the user's state, rather than through brittle, hard-coded rules.

Procedural Generation: Create dynamic worlds, music, or stories where the rules emerge from the interaction of simple principles.

📚 Documentation & Examples We believe in learning by doing. When you create a new app, you'll find a /docs folder containing:

DOT_Stack_Documentation.md: The official documentation explaining the architecture and philosophy.

CIVA_Architectural_Examples.md: A file with 20+ practical examples, showing you how to convert traditional "Old Way" code into the resilient "CIVA Way."

🤝 Contributing The DOT Stack is a new paradigm, and we welcome pioneers. If you want to contribute, please check our GitHub repository for open issues and guidelines.

📜 License The CIVA Emergent Framework and the DOT Stack are dual-licensed.

Non-Commercial Use: Licensed under Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0).

Commercial Use: A paid license is required for any commercial applications. Please contact the author, Suyash Srivastava; or CIVA corp for licensing details.