feat: bootstrap vela UI and gateway workspace

Establish the monorepo, tooling, and starter apps so UI and gateway development can begin from a documented, runnable baseline.
2026-04-08 17:49:46 +02:00
commit bba0095bc0
23 changed files with 2023 additions and 0 deletions
--- a/apps/vela-gateway/README.md
+++ b/apps/vela-gateway/README.md
@@ -0,0 +1,9 @@
+# vela-gateway
+
+This workspace contains the Vela gateway service as a minimal Fastify app.
+
+Current status:
+
+- Fastify server boots in the Yarn workspace
+- `/` and `/health` endpoints provide a runnable service baseline
+- WebSocket session orchestration remains a later increment
--- a/apps/vela-gateway/package.json
+++ b/apps/vela-gateway/package.json
@@ -0,0 +1,14 @@
+{
+  "name": "vela-gateway",
+  "private": true,
+  "version": "0.0.0",
+  "description": "Minimal Fastify app for the Vela gateway service.",
+  "scripts": {
+    "dev": "node --watch src/index.js",
+    "start": "node src/index.js",
+    "build": "node -e \"console.log('vela-gateway: no build step required')\""
+  },
+  "dependencies": {
+    "fastify": "^5.2.1"
+  }
+}
--- a/apps/vela-gateway/src/index.js
+++ b/apps/vela-gateway/src/index.js
@@ -0,0 +1,37 @@
+const Fastify = require('fastify');
+
+function buildServer() {
+	const app = Fastify({ logger: true });
+
+	app.get('/', async () => ({
+		service: 'vela-gateway',
+		status: 'ok',
+		transport: 'http',
+		next: 'websocket session skeleton'
+	}));
+
+	app.get('/health', async () => ({ status: 'ok' }));
+
+	return app;
+}
+
+async function start() {
+	const app = buildServer();
+	const port = Number(process.env.PORT ?? 3001);
+	const host = process.env.HOST ?? '0.0.0.0';
+
+	try {
+		await app.listen({ port, host });
+	} catch (error) {
+		app.log.error(error);
+		process.exit(1);
+	}
+}
+
+if (require.main === module) {
+	start();
+}
+
+module.exports = {
+	buildServer
+};
--- a/apps/vela-ui/README.md
+++ b/apps/vela-ui/README.md
@@ -0,0 +1,9 @@
+# vela-ui
+
+This workspace contains the Vela browser UI as a minimal SvelteKit app.
+
+Current status:
+
+- SvelteKit app boots in the Yarn workspace
+- root page shows the initial Vela UI starter screen
+- PWA features and voice interaction flows remain future increments
--- a/apps/vela-ui/jsconfig.json
+++ b/apps/vela-ui/jsconfig.json
@@ -0,0 +1,11 @@
+{
+	"compilerOptions": {
+		"module": "esnext",
+		"moduleResolution": "bundler",
+		"target": "esnext",
+		"strict": true,
+		"sourceMap": true,
+		"types": ["svelte"]
+	},
+	"extends": "./.svelte-kit/tsconfig.json"
+}
--- a/apps/vela-ui/package.json
+++ b/apps/vela-ui/package.json
@@ -0,0 +1,24 @@
+{
+  "name": "vela-ui",
+  "private": true,
+  "version": "0.0.0",
+  "description": "Minimal SvelteKit app for the Vela browser UI.",
+  "type": "module",
+  "scripts": {
+    "dev": "svelte-kit sync && vite dev",
+    "build": "svelte-kit sync && vite build",
+    "preview": "vite preview",
+    "check": "svelte-kit sync && svelte-check --tsconfig ./jsconfig.json"
+  },
+  "dependencies": {
+    "@sveltejs/adapter-auto": "^3.3.1",
+    "@sveltejs/kit": "^2.17.1",
+    "svelte": "^5.19.5"
+  },
+  "devDependencies": {
+    "@sveltejs/vite-plugin-svelte": "^5.0.3",
+    "svelte-check": "^4.1.4",
+    "typescript": "^5.7.3",
+    "vite": "^6.0.11"
+  }
+}
--- a/apps/vela-ui/src/app.html
+++ b/apps/vela-ui/src/app.html
@@ -0,0 +1,11 @@
+<!doctype html>
+<html lang="en">
+	<head>
+		<meta charset="utf-8" />
+		<meta name="viewport" content="width=device-width, initial-scale=1" />
+		%sveltekit.head%
+	</head>
+	<body data-sveltekit-preload-data="hover">
+		<div style="display: contents">%sveltekit.body%</div>
+	</body>
+</html>
--- a/apps/vela-ui/src/routes/+page.svelte
+++ b/apps/vela-ui/src/routes/+page.svelte
@@ -0,0 +1,101 @@
+<svelte:head>
+	<title>Vela UI</title>
+	<meta
+		name="description"
+		content="Minimal starter UI for the Vela voice assistant."
+	/>
+</svelte:head>
+
+<script>
+	const appStatus = 'Bootstrapped';
+	const nextFocus = 'Wire the voice session contract to the gateway.';
+</script>
+
+<div class="page">
+	<section class="card">
+		<p class="eyebrow">Vela UI</p>
+		<h1>Minimal SvelteKit starter</h1>
+		<p>
+			This workspace now runs as the browser shell for Vela. The voice controls, transcript, and
+			streaming session UI will be added in later increments.
+		</p>
+
+		<div class="meta">
+			<div>
+				<span>Status</span>
+				<strong>{appStatus}</strong>
+			</div>
+			<div>
+				<span>Next</span>
+				<strong>{nextFocus}</strong>
+			</div>
+		</div>
+	</section>
+</div>
+
+<style>
+	:global(body) {
+		margin: 0;
+		font-family: Inter, system-ui, sans-serif;
+		background: #08111f;
+		color: #e6eef8;
+	}
+
+	.page {
+		min-height: 100vh;
+		display: grid;
+		place-items: center;
+		padding: 2rem;
+	}
+
+	.card {
+		max-width: 42rem;
+		padding: 2rem;
+		border: 1px solid #1f3147;
+		border-radius: 1rem;
+		background: linear-gradient(180deg, #0d1728 0%, #0a1321 100%);
+		box-shadow: 0 24px 80px rgba(0, 0, 0, 0.35);
+	}
+
+	.eyebrow {
+		margin: 0 0 0.5rem;
+		text-transform: uppercase;
+		letter-spacing: 0.12em;
+		font-size: 0.8rem;
+		color: #8bb9ff;
+	}
+
+	h1 {
+		margin: 0 0 1rem;
+		font-size: clamp(2rem, 5vw, 3rem);
+	}
+
+	p {
+		margin: 0;
+		line-height: 1.6;
+		color: #c7d6e8;
+	}
+
+	.meta {
+		margin-top: 1.5rem;
+		display: grid;
+		gap: 1rem;
+	}
+
+	.meta div {
+		padding: 1rem;
+		border-radius: 0.75rem;
+		background: rgba(139, 185, 255, 0.08);
+	}
+
+	span {
+		display: block;
+		font-size: 0.85rem;
+		color: #8da3bf;
+		margin-bottom: 0.35rem;
+	}
+
+	strong {
+		font-size: 1rem;
+	}
+</style>
--- a/apps/vela-ui/svelte.config.js
+++ b/apps/vela-ui/svelte.config.js
@@ -0,0 +1,10 @@
+import adapter from '@sveltejs/adapter-auto';
+
+/** @type {import('@sveltejs/kit').Config} */
+const config = {
+	kit: {
+		adapter: adapter()
+	}
+};
+
+export default config;
--- a/apps/vela-ui/vite.config.js
+++ b/apps/vela-ui/vite.config.js
@@ -0,0 +1,6 @@
+import { sveltekit } from '@sveltejs/kit/vite';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+	plugins: [sveltekit()]
+});