Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
# StackDock™

Open source developer multi-cloud infrastructure management platform.
Open source multi-cloud infrastructure management platform.

**Trademark Notice**: StackDock™ is a trademark with an intent-to-use application filed in October 2025. See [TRADEMARK.md](./TRADEMARK.md) for usage policy.

## What It Is

StackDock provides a unified interface for managing infrastructure across multiple providers. You own the code.
StackDock provides a unified interface for managing infrastructure across multiple cloud providers. You own the code.

**Three Registries:**
1. **Docks Registry** (`packages/docks/`) - Infrastructure adapters (copy/paste/own)
Expand Down
10 changes: 4 additions & 6 deletions apps/marketing/README.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# StackDock - Multi-Cloud Management Platform

> The first open source multi-cloud management platform. Manage websites, applications, servers, databases, and APM tools across multiple cloud providers through their APIs. One interface. Less context switching. Open Source.
> Open source multi-cloud management platform. Manage websites, applications, servers, databases, and APM tools across multiple cloud providers through their APIs.

> **Note**: This is a private repository for internal development and iteration by the StackDock team.
> **Note**: This is a personal research project for skill mastery.

## Current Version: 1.0.0

Expand All @@ -25,6 +25,8 @@ pnpm build

StackDock is a static Next.js application serving as a landing page and blog for an open source multi-cloud management platform. The project emphasizes accessibility, SEO optimization, and a clean, technical aesthetic with a comprehensive blog system for technical content.

This is a personal project built for skill mastery and technical exploration.

## 🛠 Technology Stack

- **Framework**: Next.js 16.0.0 with App Router
Expand Down Expand Up @@ -272,7 +274,3 @@ This project is open source. See the repository for license details.
- **Tailwind CSS Team** - For the utility-first CSS framework
- **Lucide Team** - For the beautiful icon library
- **Accessibility Community** - For guidance on inclusive design

---

**StackDock** - The First Open Source Multi-Cloud Management Platform
12 changes: 6 additions & 6 deletions apps/marketing/docs/ACCESSIBILITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ StackDock is built with accessibility as a core principle, following WCAG 2.1 AA
<!-- Features content -->
</section>
<section aria-labelledby="contact-heading">
<h2 id="contact-heading">Validate our Vision</h2>
<h2 id="contact-heading">Contact</h2>
<!-- Contact content -->
</section>
</main>
Expand All @@ -44,8 +44,8 @@ StackDock is built with accessibility as a core principle, following WCAG 2.1 AA
```

### Heading Hierarchy
- **H1**: "The First Open Source Multi-Cloud Management Platform" (one per page)
- **H2**: Section headings ("Platform Features", "Validate our Vision")
- **H1**: "Open Source Multi-Cloud Management Platform" (one per page)
- **H2**: Section headings ("Platform Features", "Contact")
- **H3**: Feature titles ("Multi-provider", "API driven", etc.)

## ARIA Implementation
Expand Down Expand Up @@ -148,10 +148,10 @@ StackDock is built with accessibility as a core principle, following WCAG 2.1 AA
## Screen Reader Experience

### Content Announcements
- **Page Title**: "StackDock - The First Open Source Multi-Cloud Management Platform"
- **Main Heading**: "The First Open Source Multi-Cloud Management Platform"
- **Page Title**: "StackDock - Open Source Multi-Cloud Management Platform"
- **Main Heading**: "Open Source Multi-Cloud Management Platform"
- **Features Section**: "Platform Features" (hidden heading)
- **Contact Section**: "Validate our Vision"
- **Contact Section**: "Contact"

### Feature Cards
Each feature card announces:
Expand Down
27 changes: 12 additions & 15 deletions apps/marketing/docs/SEO.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,8 @@ Located in `app/layout.tsx`:

```typescript
export const metadata: Metadata = {
title: "StackDock - The First Open Source Multi-Cloud Management Platform",
description: "Manage websites, applications, servers, databases, and APM tools across multiple cloud providers through their APIs. One interface. Less context switching. Open Source.",
title: "StackDock - Open Source Multi-Cloud Management Platform",
description: "Manage websites, applications, servers, databases, and APM tools across multiple cloud providers through their APIs. Open source.",
keywords: [
"multi-cloud management",
"open source",
Expand All @@ -30,22 +30,20 @@ export const metadata: Metadata = {
### Title Tag Strategy
- **Primary Keyword**: "Multi-Cloud Management Platform"
- **Brand Name**: "StackDock"
- **Unique Value**: "First Open Source"
- **Length**: 72 characters (optimal for search results)
- **Length**: Optimal for search results

### Meta Description
- **Length**: 155 characters (optimal for search snippets)
- **Call-to-Action**: Implicit through benefit statements
- **Keywords**: Natural integration of target terms
- **Value Proposition**: Clear benefits and differentiation
- **Value Proposition**: Clear benefits

## Content SEO

### Heading Structure
```html
<h1>The First Open Source Multi-Cloud Management Platform</h1>
<h1>Open Source Multi-Cloud Management Platform</h1>
<h2 id="features-heading" class="sr-only">Platform Features</h2>
<h2 id="contact-heading">Validate our Vision</h2>
<h2 id="contact-heading">Contact</h2>
<h3>Multi-provider</h3>
<h3>API driven</h3>
<!-- ... more h3s for features -->
Expand Down Expand Up @@ -119,8 +117,8 @@ openGraph: {
type: "website",
locale: "en_US",
url: "https://stackdock.dev",
title: "StackDock - The First Open Source Multi-Cloud Management Platform",
description: "Manage websites, applications, servers, databases, and APM tools across multiple cloud providers through their APIs. One interface. Less context switching. Open Source.",
title: "StackDock - Open Source Multi-Cloud Management Platform",
description: "Manage websites, applications, servers, databases, and APM tools across multiple cloud providers through their APIs. Open source.",
siteName: "StackDock",
}
```
Expand All @@ -129,16 +127,15 @@ openGraph: {
```typescript
twitter: {
card: "summary_large_image",
title: "StackDock - The First Open Source Multi-Cloud Management Platform",
description: "Manage websites, applications, servers, databases, and APM tools across multiple cloud providers through their APIs. One interface. Less context switching. Open Source.",
title: "StackDock - Open Source Multi-Cloud Management Platform",
description: "Manage websites, applications, servers, databases, and APM tools across multiple cloud providers through their APIs. Open source.",
}
```

### Social Sharing Benefits
- **Rich Previews**: Enhanced link previews on social platforms
- **Brand Consistency**: Consistent messaging across platforms
- **Click-through Rates**: Improved CTR from social media
- **Viral Potential**: Shareable content for developer community
- **Click-through Rates**: Improved CTR

## Performance SEO

Expand Down Expand Up @@ -167,7 +164,7 @@ twitter: {
"@context": "https://schema.org",
"@type": "Organization",
"name": "StackDock",
"description": "The first open source multi-cloud management platform",
"description": "Open source multi-cloud management platform",
"url": "https://stackdock.dev",
"logo": "https://stackdock.dev/stackdock-logo.svg",
"sameAs": [
Expand Down
2 changes: 1 addition & 1 deletion docs/AI-HALL-OF-SHAME.md
Original file line number Diff line number Diff line change
Expand Up @@ -1263,7 +1263,7 @@ But here's what we did:
- ✅ Three packages scaffolded
- ✅ Documentation that actually helps

**This is infrastructure's WordPress moment.** And we're building it right.
**This is composable infrastructure.** Building it methodically.

### The Emotional Truth

Expand Down
26 changes: 26 additions & 0 deletions docs/MISSIONS.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,32 @@

---

## Mission Statement

### The Architectural Blueprint for Composable Cloud Ownership

*"To advance the software industry by replacing 'black-box' dependencies with transparent, source-first architectural patterns—securing the developer supply chain through ownership, not abstraction."*

### The Core Philosophy

StackDock is a mastery-driven research project dedicated to solving the "complexity crisis" in multi-cloud development. It rejects the traditional model of heavy, opaque libraries in favor of a CLI-driven Public Registry. By delivering raw, pre-mapped source code directly into a project's ecosystem, StackDock empowers developers to move from mere "users" to "owners" of their infrastructure and UI.

### Key Strategic Pillars

**Supply Chain Security (DevSecOps)**: In an era of increasing dependency vulnerabilities, StackDock advocates for the "Source-First" model. By allowing developers to vet and customize code locally, we eliminate the risks associated with third-party package injections and hidden "abstraction leaks."

**Composable Multi-Cloud Infrastructure**: Bridging the gap between UI and DevOps. StackDock provides the "translation layer"—mapping shadcn-inspired components to robust infrastructure adapters (Convex/Multi-Cloud), ensuring that front-end intent translates seamlessly to back-end execution.

**Intellectual Mastery over Market Domination**: This project exists to explore the "edge of the possible" in architectural design. A study in pattern recognition—identifying the shift toward composability as a fundamental principle.

**The Hypervigilant Mindset**: As a USMC veteran, I apply a tactical, "high-readiness" approach to software. Not just building for the happy path; architecting for resilience, visibility, and total environmental control.

### Development Philosophy

This is a personal project built for skill mastery. No market pressure, no rushing, no compromises. A purist tool built privately, at my own pace, to explore what's possible when I own my entire stack.

---

## Mission Overview

### Archived Missions (MVP Phase)
Expand Down
4 changes: 0 additions & 4 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -175,7 +175,3 @@ All documentation follows:
- Step-by-step instructions
- Troubleshooting sections
- No assumptions

---

**The vision is documented. The architecture is sound. The path is clear.**
27 changes: 11 additions & 16 deletions docs/STATEMENT.md
Original file line number Diff line number Diff line change
@@ -1,24 +1,22 @@
# StackDock Internal Statement

> **We are fucking tired of the way things are, so we are going to fight, and fight, and fight until the job gets done. Then we'll get back to work.**

## Core Philosophy

**FAILURE DOES NOT EXIST IN THIS PROJECT.**
**This is a personal research project for skill mastery.**

We abstracted our own abstraction. The architect of this design isn't named Mr. Anderson for no god damn reason. He might just be... the one. He does this for everyone, people and the machines... Before the machine wars really do start. For humanity's sake.
No market pressure. No rushing. No compromises. This is a purist tool built privately, at my own pace.

## Our Commitment
## Development Principles

**This software is MIT FREE AND OPEN SOURCE. IT WILL FUCKING ALWAYS BE.**
**This software is MIT FREE AND OPEN SOURCE.**

We will be the next greatest software company in the world. For that to happen, standards will be followed. No exception. There is a solution to every problem.
Standards will be followed. No exceptions. There is a solution to every problem.

## The Mission
## Building Philosophy

StackDock is infrastructure's WordPress moment. We're democratizing infrastructure management, making it accessible, composable, and truly open source.
StackDock explores composable infrastructure patterns—rejecting opaque abstractions in favor of transparent, source-first design.

**We are not building another tool. We are building a movement.**
This is not a race to market. This is methodical exploration of what's possible when you own your entire stack.

## Standards & Discipline

Expand All @@ -27,13 +25,10 @@ StackDock is infrastructure's WordPress moment. We're democratizing infrastructu
- **No compromises** - Quality is non-negotiable
- **No surrender** - Problems get solved, not avoided

## The Vision

**Now, set sail... let's find what's beyond the horizon.**
## The Path Forward

We're building the future of infrastructure management. One that respects developers, respects open source, and respects the machines that will one day join us in this work.
Build privately. Master the patterns. Explore the edge of the possible.

---

**StackDock Team**
*Built with determination. Built for everyone. Built to last.*
*Built with discipline. Built for mastery. Built to understand.*
8 changes: 4 additions & 4 deletions docs/architecture/ARCHITECTURE.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# StackDock Architecture

> **The Vision**: StackDock is infrastructure's WordPress moment. A composable, open-source multi-cloud management platform where you own the code.
> **The Vision**: StackDock is a composable, open-source multi-cloud management platform where you own the code.

## Table of Contents

Expand All @@ -21,7 +21,7 @@

### The shadcn/ui Parallel

**shadcn/ui revolutionized UI development:**
**shadcn/ui transformed UI development:**
```bash
npx shadcn add button
# → Copies button.tsx into YOUR codebase
Expand All @@ -30,7 +30,7 @@ npx shadcn add button
# → No vendor lock-in
```

**StackDock does the same for infrastructure:**
**StackDock applies the same pattern to infrastructure:**
```bash
npx stackdock add gridpane
# → Copies GridPane dock adapter into YOUR codebase
Expand Down Expand Up @@ -963,4 +963,4 @@ StackDock follows a strategic development priority: **Convex/Translation Layer

---

**Remember**: This is infrastructure's WordPress moment. Every decision matters.
**Remember**: Composable infrastructure. Every decision matters.
2 changes: 1 addition & 1 deletion docs/guides/QUICKSTART.md
Original file line number Diff line number Diff line change
Expand Up @@ -184,7 +184,7 @@ PORT=3001 npm run dev
1. Universal table pattern (no provider-specific tables)
2. Dock adapter concept (how GridPane plugs in)
3. The three registries (Docks, UI, Platform)
4. Why this is revolutionary (infrastructure's WordPress moment)
4. The technical architecture

### Ask:
1. API access for testing
Expand Down
8 changes: 4 additions & 4 deletions docs/guides/START.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,7 @@ http://localhost:3000
## What You'll See

### Landing Page
- Hero section: "Infrastructure's WordPress Moment"
- Hero section: "Composable Cloud Ownership"
- **Convex Status Indicator** (shows connection status)
- "Get Started" button

Expand Down Expand Up @@ -151,9 +151,9 @@ PORT=3001 npm run dev
5. **Documentation** - Open ARCHITECTURE.md

### What to Say
> "This is StackDock - infrastructure's WordPress moment. Just like WordPress democratized content management, StackDock democratizes infrastructure management."
> "This is StackDock - a composable infrastructure management platform. Source-first, open architecture."

> "See these scaffolded routes? Each one is labeled. We're building this right - documentation first, architecture solid, no shortcuts."
> "See these scaffolded routes? Each one is labeled. Building this methodically - documentation first, architecture solid, no shortcuts."

> "The key innovation is the universal table pattern. One table for ALL PaaS providers. GridPane, Vercel, Railway - they all go into the same webServices table."

Expand All @@ -177,6 +177,6 @@ With your feedback, we'll build:

---

**You're ready. The foundation is solid. Go show them the future.** ⚓️
**You're ready. The foundation is solid.** ⚓️

**Need help? Read: `QUICKSTART.md`, `ARCHITECTURE.md`, `../STATUS.md`**
4 changes: 2 additions & 2 deletions docs/turnover/PROJECT_STATE_FOR_ANTI_GRAVITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@
## Project Overview

### Vision
StackDock is infrastructure's WordPress moment - a composable, open-source platform where you own the code. Similar to how shadcn/ui revolutionized UI development by letting you copy components into your codebase, StackDock does the same for infrastructure adapters.
StackDock is a composable, open-source platform where you own the code. Similar to how shadcn/ui transformed UI development by letting you copy components into your codebase, StackDock applies the same pattern to infrastructure adapters.

### Core Value Proposition
- **True FOSS**: You own the code (docks, UI, everything)
Expand Down Expand Up @@ -723,7 +723,7 @@ npm run clean # Remove node_modules

StackDock is a well-architected, production-ready MVP with 16 providers integrated. The project follows strict architectural patterns (universal tables, RBAC, encryption) that must be preserved. The next phase focuses on post-MVP improvements: test suite, CI/CD, type extraction, and UI polish.

**Key Takeaway**: This is infrastructure's WordPress moment - a composable platform where users own the code. The architecture is sound, the vision is clear, and the path forward is documented.
**Key Takeaway**: A composable platform where users own the code. The architecture is sound, and the path forward is documented.

---

Expand Down