Initial implementation of the Devfile GUI Wizard

.dockerignore

@@ -0,0 +1,18 @@
+node_modules
+npm-debug.log
+dist
+.git
+.gitignore
+README.md
+.env
+.env.local
+.env.*.local
+.vscode
+.idea
+*.log
+.DS_Store
+coverage
+.nyc_output
+Claude.md
+.mcp.json
+.claude

.github/workflows/deploy.yaml

@@ -13,10 +13,17 @@ jobs:
     steps:
       - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5 # v4.3.1
 
-      - name: Make target export directory
-        run: mkdir -p public/
+      - name: Setup Node.js
+        uses: actions/setup-node@39370e3970a6d050c480ffad4ff0ed4d3fdee5af # v4.1.0
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
 
-      ## TODO: Add site build and export steps here, target public/ for export directory
+      - name: Build site
+        run: npm run build
 
       - name: Copy CNAME
         run: cp CNAME public

.gitignore

@@ -0,0 +1,110 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# Dependencies
+node_modules
+.pnp
+.pnp.js
+
+# Build outputs
+dist
+dist-ssr
+build
+*.local
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Testing
+coverage
+.nyc_output
+*.lcov
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+.idea
+*.swp
+*.swo
+*~
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# OS files
+Thumbs.db
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Desktop.ini
+
+# Temporary files
+*.tmp
+*.temp
+.cache
+.parcel-cache
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env*.local
+
+# Vite
+.vite
+
+# TypeScript
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Storybook build outputs
+storybook-static
+
+# Temporary folders
+tmp/
+temp/

.mcp.json

@@ -0,0 +1,16 @@
+{
+    "mcpServers": {
+      "context7": {
+        "command": "npx",
+        "args": ["-y", "@upstash/context7-mcp"]
+      },
+      "playwright": {
+        "type": "stdio",
+        "command": "npx",
+        "args": [
+          "@playwright/mcp@latest"
+        ],
+        "env": {}
+      }
+    }
+  }

.vscode/extensions.json

@@ -0,0 +1,9 @@
+{
+    // See https://go.microsoft.com/fwlink/?LinkId=827846
+    // for the documentation about the extensions.json format
+    "recommendations": [
+      "Anthropic.claude-code",
+      "github.vscode-pull-request-github",
+      "RooVeterinaryInc.roo-cline"
+    ]
+}

Claude.md

@@ -0,0 +1,57 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+This repository contains a single-page React application for creating devfiles through a user-friendly GUI wizard. The application uses React and Tailwind CSS to provide a step-by-step interface for generating devfile 2.3.0 compliant YAML files.
+
+**Key Resources:**
+- Devfile specification: https://devfile.io/docs/
+- Feature request: https://github.com/devfile/api/issues/1765
+- Devfile 2.3.0 spec should be the target version
+
+## Project Architecture
+
+**Application Type:** Single-page application (SPA) with no backend or persistent state
+**UI Framework:** React
+**Styling:** Tailwind CSS
+**Output:** Generated devfile.yaml files available for download
+
+The application is stateless - all devfile generation happens client-side with no data persistence.
+
+## Development Commands
+
+This section will be populated once the project structure is initialized. Expected commands include:
+- `npm install` - Install dependencies
+- `npm run dev` - Start development server
+- `npm run build` - Build for production
+- `npm run lint` - Run linter
+- `npm run test` - Run tests (if applicable)
+
+## MCP Servers
+
+This project uses the following MCP servers (configured in `.mcp.json`):
+
+- **context7**: Provides up-to-date React and Tailwind CSS documentation
+- **playwright**: For browser automation and testing
+
+## Key Implementation Requirements
+
+1. **Step-by-step wizard interface** - Guide users through devfile creation with clear, sequential steps
+2. **Devfile 2.3.0 compliance** - Generated YAML must conform to the devfile 2.3.0 specification
+3. **Download capability** - Users must be able to download the generated devfile.yaml
+4. **Single page design** - All functionality contained in one web page with no routing
+5. **No state persistence** - Application does not save or persist user data between sessions
+
+## Devfile Concepts to Understand
+
+When working with this codebase, familiarize yourself with these devfile concepts:
+- Components (containers, volumes, kubernetes resources)
+- Commands (exec, apply, composite)
+- Events (preStart, postStart, preStop, postStop)
+- Projects (git repositories)
+- StarterProjects (templates)
+- Metadata (name, version, description, attributes)
+
+Refer to https://devfile.io/docs/ for detailed schema and examples.

Dockerfile

@@ -0,0 +1,50 @@
+# Multi-stage build for production
+
+# Stage 1: Build the application
+FROM node:18-alpine AS builder
+
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+
+# Install dependencies
+RUN npm ci
+
+# Copy source code
+COPY . .
+
+# Build the application
+RUN npm run build
+
+# Stage 2: Serve with nginx
+FROM nginx:alpine
+
+# Copy built assets from builder stage
+COPY --from=builder /app/dist /usr/share/nginx/html
+
+# Copy nginx configuration
+COPY nginx.conf /etc/nginx/conf.d/default.conf
+
+# Create nginx cache directories with world-writable permissions for OpenShift
+# OpenShift will assign a random UID, so we make directories writable by any user
+RUN mkdir -p /var/cache/nginx/client_temp \
+    && mkdir -p /var/cache/nginx/proxy_temp \
+    && mkdir -p /var/cache/nginx/fastcgi_temp \
+    && mkdir -p /var/cache/nginx/uwsgi_temp \
+    && mkdir -p /var/cache/nginx/scgi_temp \
+    && chmod -R 777 /var/cache/nginx \
+    && chmod -R 777 /var/log/nginx \
+    && chmod -R 755 /etc/nginx/conf.d \
+    && chmod -R 755 /usr/share/nginx/html \
+    && touch /var/run/nginx.pid \
+    && chmod 777 /var/run/nginx.pid
+
+# Don't set USER - let OpenShift assign the UID
+# OpenShift will enforce runAsNonRoot via security context
+
+# Expose port 8080 (non-root)
+EXPOSE 8080
+
+# Start nginx
+CMD ["nginx", "-g", "daemon off;"]

Dockerfile.dev

@@ -0,0 +1,19 @@
+# Development Dockerfile
+FROM node:18-alpine
+
+WORKDIR /app
+
+# Copy package files
+COPY package*.json ./
+
+# Install dependencies
+RUN npm ci
+
+# Copy source code
+COPY . .
+
+# Expose Vite dev server port
+EXPOSE 5173
+
+# Start development server
+CMD ["npm", "run", "dev", "--", "--host", "0.0.0.0"]