Add complete Neutron documentation structure

.gitignore

@@ -5,7 +5,7 @@
 /build
 
 # Generated files
-.docusaurus
+.mintlify
 .cache-loader
 
 # Misc
@@ -20,3 +20,10 @@ yarn-debug.log*
 yarn-error.log*
 
 .idea/
+
+/concepts-reference
+/module-reference
+/old-docs
+/interchain-queries-reference
+
+CLAUDE.md

README.md

@@ -1,41 +1,108 @@
-# Website
+# Neutron Documentation
 
-This website is built using [Docusaurus 2](https://docusaurus.io/), a modern static website generator.
+The comprehensive documentation hub for the Neutron blockchain - the first Consumer Chain of the Cosmos Hub. This repository contains detailed guides, tutorials, and references for developers, validators, and users of the Neutron ecosystem.
 
-### Installation
+## 🌟 What is Neutron?
 
-```
-$ yarn
-```
+Neutron is a permissionless smart contract platform that leverages Interchain Security (ICS) from Cosmos Hub, enabling secure cross-chain DeFi applications with native integrations to 50+ Cosmos chains and beyond.
+
+## 📖 Documentation Structure
+
+### 🏠 **Home & Core Concepts**
+- **Introduction & Quickstart**: Get started with Neutron basics
+- **Integrated Architecture**: Understanding Neutron's unique Consumer Chain design
+- **Opinionated Blockchains**: How Neutron enables focused blockchain applications
+- **Proof of Liquid Staking**: Neutron's innovative consensus and security model
+- **Modular Governance**: Decentralized decision-making mechanisms
+- **Tokenomics**: NTRN token economics and utility
+
+### 💹 **DeFi Ecosystem**
+- **DeFi Overview**: Complete landscape of Neutron's financial applications
+- **Featured Protocols**: Duality, SuperVaults, Bull vs Bear, Drop Staking
+- **Integration Guides**: How to connect with Neutron's DeFi infrastructure
+
+### 👨‍💻 **Developer Resources**
+- **Getting Started**: Developer onboarding and environment setup
+- **SDK & Tools**: Neutron Template, BullBear integration, boilerplates
+- **Comprehensive Tutorials**: 
+  - CosmWasm smart contract development
+  - Interchain Accounts (ICA) and Queries (ICQ)
+  - Integration testing and deployment
+  - Indexing and data analysis
+- **Modules Documentation**: Deep dives into Neutron's custom modules
+- **API Reference**: Complete technical specifications
+
+### 🔒 **Validator Operations**
+- **Overview**: Complete validator ecosystem and requirements
+- **Node Setup**: Comprehensive guide for running Neutron nodes
+- **Becoming a Validator**: Step-by-step validator registration process
+- **Oracle Operations**: Slinky oracle setup and maintenance
+- **Economics**: Validator incentives, rewards, and performance metrics
+- **Security**: Best practices and operational guidelines
+
+## 🛠 Development
+
+This documentation is built with [Mintlify](https://mintlify.com), a modern documentation platform designed for developer-focused content.
 
 ### Local Development
 
-```
-$ yarn start
-```
+1. **Install Mintlify CLI**:
+   ```bash
+   npm i -g mintlify
+   ```
+
+2. **Preview documentation locally**:
+   ```bash
+   mintlify dev
+   ```
+
+3. **Install dependencies** (if needed):
+   ```bash
+   mintlify install
+   ```
+
+### Publishing Changes
+
+Documentation is automatically deployed when changes are pushed to the default branch. For more information about Mintlify's deployment process, visit the [Mintlify documentation](https://mintlify.com/docs).
+
+### Troubleshooting
+
+- **Mintlify dev isn't running**: Run `mintlify install` to re-install dependencies
+- **Page loads as a 404**: Make sure you are running in a folder with `docs.json`
+- **Build errors**: Check the [Mintlify troubleshooting guide](https://mintlify.com/docs/troubleshooting)
+
+### Key Features
 
-This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+- 🎨 **Beautiful Design**: Modern, responsive interface with dark/light modes
+- 🔍 **Advanced Search**: Full-text search across all documentation
+- 📱 **Mobile Optimized**: Perfect experience on all devices
+- 🔗 **Deep Linking**: Direct links to specific sections and code blocks
+- 💻 **Code Examples**: Interactive code samples and tutorials
+- 🌐 **Multi-format Support**: MDX, API references, and rich media
 
-### Build
+## 🌐 Community & Resources
 
-```
-$ yarn build
-```
+### Official Links
+- **Website**: [neutron.org](https://neutron.org)
+- **App**: [app.neutron.org](https://app.neutron.org)
+- **GitHub**: [github.com/neutron-org](https://github.com/neutron-org)
 
-This command generates static content into the `build` directory and can be served using any static contents hosting service.
+### Community
+- **Discord**: [Join our community](https://discord.com/invite/bzPBzbDvWC)
+- **Twitter**: [@neutron_org](https://twitter.com/neutron_org)
+- **Forum**: [Neutron Governance](https://forum.neutron.org)
 
-### Deployment
+## 📊 Repository Statistics
 
-Using SSH:
+- **Comprehensive Coverage**: 100+ documentation pages
+- **Multi-audience**: Developers, validators, and end users
+- **Active Maintenance**: Regular updates with protocol developments
+- **Community Driven**: Open source with community contributions
 
-```
-$ USE_SSH=true yarn deploy
-```
+## 📝 License
 
-Not using SSH:
+This documentation is open source and available under the [MIT License](LICENSE).
 
-```
-$ GIT_USER=<Your GitHub username> yarn deploy
-```
+---
 
-If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
+*Neutron: Secure, interoperable, and developer-friendly blockchain infrastructure for the next generation of DeFi.*

concepts/integrated-architecture.mdx

@@ -0,0 +1,97 @@
+---
+title: "Integrated Architecture"
+description: "How Neutron's DeFi-focused infrastructure combines app-specific features with atomic composability"
+icon: "puzzle-piece"
+---
+
+Neutron implements an integrated blockchain architecture that combines critical DeFi infrastructure directly at the protocol layer. This design ensures guaranteed execution, native cross-chain communication, atomic composability, and predictable performance—creating a shared environment where DeFi protocols benefit from specialized infrastructure without sacrificing interoperability.
+
+## Core Infrastructure 
+
+<CardGroup cols={2}>
+  <Card title="Oracle Module" icon="bolt" iconType="duotone" href="/developers/modules/oracle">
+    Native price feeds updated every block with hardware-based security, eliminating dependence on external oracles and providing superior execution guarantees.
+  </Card>
+  <Card title="Interchain Queries (ICQ)" icon="network-wired" iconType="duotone" href="/developers/modules/interchain-queries">
+    Direct state queries across any IBC-connected chain, enabling real-time cross-chain data access without trusted third parties.
+  </Card>
+  <Card title="Cron Module" icon="clock" iconType="duotone" href="/developers/modules/cron">
+    Native automation allowing scheduled and conditional contract execution with protocol-level reliability.
+  </Card>
+  <Card title="Interchain Accounts" icon="arrows-left-right" iconType="duotone" href="/developers/tutorials/cosmwasm_ica">
+    Built-in interchain account functionality enabling seamless cross-chain operations with consensus-enforced security.
+  </Card>
+</CardGroup>
+
+This approach essentially provides infrastructure as a service at the protocol level, allowing all applications to leverage shared utilities without building duplicate systems or relying on external providers.
+
+## Benefits of Integration
+
+<CardGroup cols={2}>
+  <Card title="Capital Efficiency" icon="coins" iconType="duotone">
+    <ul className="mt-2 space-y-1">
+      <li>Optimized liquidity utilization across protocols</li>
+      <li>Reduced capital requirements through composability</li>
+    </ul>
+  </Card>
+
+  <Card title="Reliability" icon="shield-check" iconType="duotone">
+    <ul className="mt-2 space-y-1">
+      <li>Infrastructure failures are consensus failures</li>
+      <li>Guaranteed execution within block boundaries</li>
+    </ul>
+  </Card>
+
+  <Card title="Performance" icon="bolt" iconType="duotone">
+    <ul className="mt-2 space-y-1">
+      <li>Direct state access without contract calls</li>
+      <li>High-frequency oracle updates every block</li>
+    </ul>
+  </Card>
+
+  <Card title="Security" icon="lock" iconType="duotone">
+    <ul className="mt-2 space-y-1">
+      <li>Protocol-level validation of all operations</li>
+      <li>No trusted external oracles or bridges</li>
+    </ul>
+  </Card>
+</CardGroup>
+
+## Atomic Composability
+
+Neutron enables true atomic composability across all protocol features within a single transaction:
+
+```mermaid
+graph LR
+  A[Smart Contract] --> B[Oracle Module]
+  A --> C[Token Transfer]
+  A --> D[Interchain Query]
+  A --> E[Cron Automation]
+
+  B & C & D & E -.-> F[Unified Transaction State]
+
+  classDef default fill:#f5f5f5,stroke:#d9d9d9,color:#333
+  classDef contract fill:#0ea5e9,stroke:#0284c7,color:white
+
+  class A contract
+```
+
+All operations execute atomically in a single transaction context, providing developers with strong guarantees while eliminating interoperability risks.
+
+## Real-World Applications
+
+### Supervaults
+[Supervaults](/defi/supervaults) represent a new approach to liquidity provision that overcomes the limitations of traditional AMMs. By leveraging Neutron's built-in high-frequency oracle and native automation features, Supervaults can:
+
+- Market make at the most recent CEX prices
+- Automatically rebalance every block
+- Perform arbitrage themselves instead of being arbitraged
+- Democratize profits to liquidity providers
+
+### Cross-Chain Liquid Staking
+Protocols like [Drop](/defi/drop) can utilize Neutron's Interchain Accounts and Interchain Queries (ICQ) capabilities to:
+
+- Read the state of other blockchains
+- Adjust delegations made by remotely controlled accounts
+- Onboard new assets from connected chains with a single transaction
+- Provide users with a seamless cross-chain staking experience