Merge commit '82b0a9baca6bf7bfcba062b9f95b996aee752b5e'

README.md

@@ -11,6 +11,31 @@ Operator / admin console for BlackRoad OS services. This frontend surfaces syste
 Install dependencies and run the development server:
 
 ```bash
+# blackroad-os-prism-console
+
+Prism console for BlackRoad OS — environments, deployments, observability, admin views.
+
+## Project Structure
+
+```
+blackroad-os-prism-console/
+├── frontend/          # Next.js application
+│   ├── app/          # Next.js App Router pages
+│   │   ├── environments/  # Environments page
+│   │   ├── deployments/   # Deployments page
+│   │   └── logs/          # Logs page
+│   └── components/   # Reusable React components
+├── backend/          # Placeholder for future API services
+└── infra/            # Infrastructure and environment configs
+    └── env.example   # Environment configuration template
+```
+
+## Getting Started
+
+### Frontend Development
+
+```bash
+cd frontend
 npm install
 npm run dev
 ```
@@ -46,3 +71,34 @@ See `.env.example` for available variables. Key values:
 ## Additional Notes
 - Base URL: https://console.blackroad.systems
 - OS Root: https://blackroad.systems
+The application will be available at `http://localhost:3000`.
+
+### Features
+
+- **Environments**: Manage deployment environments
+- **Deployments**: Track and control application deployments  
+- **Logs**: Monitor and analyze system logs
+
+## Deployment
+
+This project is designed to be deployed on:
+- **Frontend**: Railway or Cloudflare Pages
+- **Backend**: Railway (when implemented)
+
+See `infra/env.example` for required environment variables.
+
+## Development Roadmap
+
+- [x] Basic Next.js frontend structure
+- [x] Sidebar navigation
+- [x] Placeholder pages for main sections
+- [ ] Backend API implementation
+- [ ] Database integration
+- [ ] Authentication
+- [ ] Deployment automation
+- [ ] Cloudflare/Railway integration
+
+## License
+
+See [LICENSE](LICENSE) file for details.
+

backend/README.md

@@ -0,0 +1,15 @@
+# Backend
+
+Placeholder folder for future API calls and backend services.
+
+## Structure
+
+This directory will contain:
+- API routes and endpoints
+- Database models and migrations
+- Business logic and services
+- Authentication and authorization logic
+
+## Coming Soon
+
+Backend implementation will be added as the project evolves.

frontend/.gitignore

@@ -0,0 +1,41 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

frontend/README.md

@@ -0,0 +1,63 @@
+# Prism Console Frontend
+
+This is the frontend application for Prism Console, built with [Next.js](https://nextjs.org) and [Tailwind CSS](https://tailwindcss.com).
+
+## Features
+
+- 📊 **Environments**: Manage deployment environments
+- 🚀 **Deployments**: Track and control application deployments
+- 📝 **Logs**: Monitor and analyze system logs
+- 🌙 **Dark Mode**: Built-in dark mode support
+- 📱 **Responsive**: Mobile-friendly sidebar navigation
+
+## Getting Started
+
+First, install dependencies:
+
+```bash
+npm install
+```
+
+Then, run the development server:
+
+```bash
+npm run dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+## Project Structure
+
+```
+frontend/
+├── app/              # Next.js App Router pages
+│   ├── environments/ # Environments page
+│   ├── deployments/  # Deployments page
+│   ├── logs/         # Logs page
+│   ├── layout.tsx    # Root layout with sidebar
+│   └── page.tsx      # Home page
+├── components/       # Reusable React components
+│   └── Sidebar.tsx   # Navigation sidebar
+└── public/           # Static assets
+```
+
+## Available Scripts
+
+- `npm run dev` - Start development server
+- `npm run build` - Build for production
+- `npm run start` - Start production server
+
+## Deploy on Railway or Cloudflare
+
+This application is ready to be deployed on:
+- **Railway**: Deploy directly from GitHub
+- **Cloudflare Pages**: Build command: `npm run build`, Output directory: `.next`
+
+See the [deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.
+
+## Tech Stack
+
+- **Next.js 16** - React framework
+- **TypeScript** - Type safety
+- **Tailwind CSS 4** - Styling
+- **React 19** - UI library

frontend/app/deployments/page.tsx

@@ -0,0 +1,15 @@
+export default function DeploymentsPage() {
+  return (
+    <div>
+      <h1 className="text-3xl font-bold mb-4">Deployments</h1>
+      <p className="text-zinc-600 dark:text-zinc-400 mb-8">
+        Track and manage your application deployments.
+      </p>
+      <div className="border border-zinc-200 dark:border-zinc-800 rounded-lg p-6">
+        <p className="text-sm text-zinc-500 dark:text-zinc-500">
+          Deployment history and controls will be available here.
+        </p>
+      </div>
+    </div>
+  );
+}

frontend/app/environments/page.tsx

@@ -0,0 +1,15 @@
+export default function EnvironmentsPage() {
+  return (
+    <div>
+      <h1 className="text-3xl font-bold mb-4">Environments</h1>
+      <p className="text-zinc-600 dark:text-zinc-400 mb-8">
+        Manage your deployment environments here.
+      </p>
+      <div className="border border-zinc-200 dark:border-zinc-800 rounded-lg p-6">
+        <p className="text-sm text-zinc-500 dark:text-zinc-500">
+          Environment configuration and management will be available here.
+        </p>
+      </div>
+    </div>
+  );
+}

frontend/app/globals.css

@@ -0,0 +1,24 @@
+@import "tailwindcss";
+
+:root {
+  --background: #ffffff;
+  --foreground: #171717;
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --background: #0a0a0a;
+    --foreground: #ededed;
+  }
+}
+
+body {
+  background: var(--background);
+  color: var(--foreground);
+  font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+}

frontend/app/layout.tsx

@@ -0,0 +1,27 @@
+import type { Metadata } from "next";
+import "./globals.css";
+import Sidebar from "@/components/Sidebar";
+
+export const metadata: Metadata = {
+  title: "Prism Console - BlackRoad OS",
+  description: "Prism console for BlackRoad OS — environments, deployments, observability, admin views.",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body className="antialiased">
+        <div className="flex">
+          <Sidebar />
+          <main className="flex-1 p-8">
+            {children}
+          </main>
+        </div>
+      </body>
+    </html>
+  );
+}

frontend/app/page.tsx

@@ -0,0 +1,30 @@
+export default function Home() {
+  return (
+    <div>
+      <h1 className="text-3xl font-bold mb-4">Welcome to Prism Console</h1>
+      <p className="text-zinc-600 dark:text-zinc-400">
+        Manage your BlackRoad OS environments, deployments, and observability from this console.
+      </p>
+      <div className="mt-8 grid grid-cols-1 md:grid-cols-3 gap-6">
+        <div className="border border-zinc-200 dark:border-zinc-800 rounded-lg p-6">
+          <h2 className="text-xl font-semibold mb-2">Environments</h2>
+          <p className="text-sm text-zinc-600 dark:text-zinc-400">
+            View and manage your deployment environments
+          </p>
+        </div>
+        <div className="border border-zinc-200 dark:border-zinc-800 rounded-lg p-6">
+          <h2 className="text-xl font-semibold mb-2">Deployments</h2>
+          <p className="text-sm text-zinc-600 dark:text-zinc-400">
+            Track and control your application deployments
+          </p>
+        </div>
+        <div className="border border-zinc-200 dark:border-zinc-800 rounded-lg p-6">
+          <h2 className="text-xl font-semibold mb-2">Logs</h2>
+          <p className="text-sm text-zinc-600 dark:text-zinc-400">
+            Monitor and analyze system logs
+          </p>
+        </div>
+      </div>
+    </div>
+  );
+}

frontend/components/Sidebar.tsx

@@ -0,0 +1,41 @@
+"use client";
+
+import Link from "next/link";
+import { usePathname } from "next/navigation";
+
+const navItems = [
+  { name: "Environments", href: "/environments" },
+  { name: "Deployments", href: "/deployments" },
+  { name: "Logs", href: "/logs" },
+];
+
+export default function Sidebar() {
+  const pathname = usePathname();
+
+  return (
+    <aside className="w-64 bg-zinc-900 text-white min-h-screen p-6">
+      <div className="mb-8">
+        <h1 className="text-xl font-bold">Prism Console</h1>
+        <p className="text-sm text-zinc-400 mt-1">BlackRoad OS</p>
+      </div>
+      <nav>
+        <ul className="space-y-2">
+          {navItems.map((item) => (
+            <li key={item.href}>
+              <Link
+                href={item.href}
+                className={`block px-4 py-2 rounded transition-colors ${
+                  pathname === item.href
+                    ? "bg-zinc-700 text-white"
+                    : "text-zinc-300 hover:bg-zinc-800"
+                }`}
+              >
+                {item.name}
+              </Link>
+            </li>
+          ))}
+        </ul>
+      </nav>
+    </aside>
+  );
+}

frontend/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+};
+
+export default nextConfig;

frontend/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "frontend",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start"
+  },
+  "dependencies": {
+    "next": "16.0.3",
+    "react": "19.2.0",
+    "react-dom": "19.2.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "tailwindcss": "^4",
+    "typescript": "^5"
+  }
+}

frontend/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

frontend/public/file.svg

@@ -0,0 +1 @@
+<svg fill="none" viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M14.5 13.5V5.41a1 1 0 0 0-.3-.7L9.8.29A1 1 0 0 0 9.08 0H1.5v13.5A2.5 2.5 0 0 0 4 16h8a2.5 2.5 0 0 0 2.5-2.5m-1.5 0v-7H8v-5H3v12a1 1 0 0 0 1 1h8a1 1 0 0 0 1-1M9.5 5V2.12L12.38 5zM5.13 5h-.62v1.25h2.12V5zm-.62 3h7.12v1.25H4.5zm.62 3h-.62v1.25h7.12V11z" clip-rule="evenodd" fill="#666" fill-rule="evenodd"/></svg>

frontend/public/globe.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><g clip-path="url(#a)"><path fill-rule="evenodd" clip-rule="evenodd" d="M10.27 14.1a6.5 6.5 0 0 0 3.67-3.45q-1.24.21-2.7.34-.31 1.83-.97 3.1M8 16A8 8 0 1 0 8 0a8 8 0 0 0 0 16m.48-1.52a7 7 0 0 1-.96 0H7.5a4 4 0 0 1-.84-1.32q-.38-.89-.63-2.08a40 40 0 0 0 3.92 0q-.25 1.2-.63 2.08a4 4 0 0 1-.84 1.31zm2.94-4.76q1.66-.15 2.95-.43a7 7 0 0 0 0-2.58q-1.3-.27-2.95-.43a18 18 0 0 1 0 3.44m-1.27-3.54a17 17 0 0 1 0 3.64 39 39 0 0 1-4.3 0 17 17 0 0 1 0-3.64 39 39 0 0 1 4.3 0m1.1-1.17q1.45.13 2.69.34a6.5 6.5 0 0 0-3.67-3.44q.65 1.26.98 3.1M8.48 1.5l.01.02q.41.37.84 1.31.38.89.63 2.08a40 40 0 0 0-3.92 0q.25-1.2.63-2.08a4 4 0 0 1 .85-1.32 7 7 0 0 1 .96 0m-2.75.4a6.5 6.5 0 0 0-3.67 3.44 29 29 0 0 1 2.7-.34q.31-1.83.97-3.1M4.58 6.28q-1.66.16-2.95.43a7 7 0 0 0 0 2.58q1.3.27 2.95.43a18 18 0 0 1 0-3.44m.17 4.71q-1.45-.12-2.69-.34a6.5 6.5 0 0 0 3.67 3.44q-.65-1.27-.98-3.1" fill="#666"/></g><defs><clipPath id="a"><path fill="#fff" d="M0 0h16v16H0z"/></clipPath></defs></svg>

frontend/public/next.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 394 80"><path fill="#000" d="M262 0h68.5v12.7h-27.2v66.6h-13.6V12.7H262V0ZM149 0v12.7H94v20.4h44.3v12.6H94v21h55v12.6H80.5V0h68.7zm34.3 0h-17.8l63.8 79.4h17.9l-32-39.7 32-39.6h-17.9l-23 28.6-23-28.6zm18.3 56.7-9-11-27.1 33.7h17.8l18.3-22.7z"/><path fill="#000" d="M81 79.3 17 0H0v79.3h13.6V17l50.2 62.3H81Zm252.6-.4c-1 0-1.8-.4-2.5-1s-1.1-1.6-1.1-2.6.3-1.8 1-2.5 1.6-1 2.6-1 1.8.3 2.5 1a3.4 3.4 0 0 1 .6 4.3 3.7 3.7 0 0 1-3 1.8zm23.2-33.5h6v23.3c0 2.1-.4 4-1.3 5.5a9.1 9.1 0 0 1-3.8 3.5c-1.6.8-3.5 1.3-5.7 1.3-2 0-3.7-.4-5.3-1s-2.8-1.8-3.7-3.2c-.9-1.3-1.4-3-1.4-5h6c.1.8.3 1.6.7 2.2s1 1.2 1.6 1.5c.7.4 1.5.5 2.4.5 1 0 1.8-.2 2.4-.6a4 4 0 0 0 1.6-1.8c.3-.8.5-1.8.5-3V45.5zm30.9 9.1a4.4 4.4 0 0 0-2-3.3 7.5 7.5 0 0 0-4.3-1.1c-1.3 0-2.4.2-3.3.5-.9.4-1.6 1-2 1.6a3.5 3.5 0 0 0-.3 4c.3.5.7.9 1.3 1.2l1.8 1 2 .5 3.2.8c1.3.3 2.5.7 3.7 1.2a13 13 0 0 1 3.2 1.8 8.1 8.1 0 0 1 3 6.5c0 2-.5 3.7-1.5 5.1a10 10 0 0 1-4.4 3.5c-1.8.8-4.1 1.2-6.8 1.2-2.6 0-4.9-.4-6.8-1.2-2-.8-3.4-2-4.5-3.5a10 10 0 0 1-1.7-5.6h6a5 5 0 0 0 3.5 4.6c1 .4 2.2.6 3.4.6 1.3 0 2.5-.2 3.5-.6 1-.4 1.8-1 2.4-1.7a4 4 0 0 0 .8-2.4c0-.9-.2-1.6-.7-2.2a11 11 0 0 0-2.1-1.4l-3.2-1-3.8-1c-2.8-.7-5-1.7-6.6-3.2a7.2 7.2 0 0 1-2.4-5.7 8 8 0 0 1 1.7-5 10 10 0 0 1 4.3-3.5c2-.8 4-1.2 6.4-1.2 2.3 0 4.4.4 6.2 1.2 1.8.8 3.2 2 4.3 3.4 1 1.4 1.5 3 1.5 5h-5.8z"/></svg>

frontend/public/vercel.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1155 1000"><path d="m577.3 0 577.4 1000H0z" fill="#fff"/></svg>

frontend/public/window.svg

@@ -0,0 +1 @@
+<svg fill="none" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 2.5h13v10a1 1 0 0 1-1 1h-11a1 1 0 0 1-1-1zM0 1h16v11.5a2.5 2.5 0 0 1-2.5 2.5h-11A2.5 2.5 0 0 1 0 12.5zm3.75 4.5a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5M7 4.75a.75.75 0 1 1-1.5 0 .75.75 0 0 1 1.5 0m1.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5" fill="#666"/></svg>

frontend/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}

infra/README.md

@@ -0,0 +1,21 @@
+# Infrastructure
+
+Placeholder folder for environment configurations and infrastructure-as-code.
+
+## Structure
+
+This directory will contain:
+- Environment configuration templates (env.example)
+- Deployment configurations
+- Infrastructure as Code (IaC) templates
+- CI/CD pipeline configurations
+
+## Getting Started
+
+1. Copy `env.example` to `.env` in your respective service directories
+2. Update the values with your actual configuration
+3. Never commit files containing real secrets or credentials
+
+## Coming Soon
+
+Infrastructure configurations for Railway and Cloudflare will be added as deployment progresses.

infra/env.example

@@ -0,0 +1,20 @@
+# Example Environment Configuration
+# Copy this file to .env and update with your actual values
+# DO NOT commit .env files with real credentials
+
+# Application
+NODE_ENV=development
+PORT=3000
+
+# Database (example - update with your actual database)
+# DATABASE_URL=postgresql://user:password@localhost:5432/prism_console
+
+# API Keys (example - add your services)
+# API_KEY=your-api-key-here
+
+# Railway Configuration (example)
+# RAILWAY_ENVIRONMENT=production
+
+# Cloudflare Configuration (example)
+# CLOUDFLARE_API_TOKEN=your-token-here
+# CLOUDFLARE_ZONE_ID=your-zone-id