@strav/spring 1.0.0-alpha.28 → 1.0.0-alpha.29

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strav/spring",
-  "version": "1.0.0-alpha.28",
+  "version": "1.0.0-alpha.29",
   "description": "Strav project scaffolder — `bunx @strav/spring my-app` writes a working app skeleton (bin/, bootstrap/, config/, routes/, …) per spec/directory-structure.md. Two templates: --api (headless REST) and --web (Vue islands + .strav views). Runtime-independent of the framework — no @strav/* runtime deps.",
   "type": "module",
   "main": "./src/index.ts",

package/src/cli.ts

@@ -20,7 +20,7 @@ const green = (s: string): string => `\x1b[32m${s}\x1b[0m`
 const red = (s: string): string => `\x1b[31m${s}\x1b[0m`
 const cyan = (s: string): string => `\x1b[36m${s}\x1b[0m`
 
-const SPRING_VERSION = '1.0.0-alpha.28'
+const SPRING_VERSION = '1.0.0-alpha.29'
 
 function printUsage(): void {
   process.stdout.write(`

package/src/templates/shared/bin/strav.ts

@@ -14,7 +14,7 @@ import { providers } from '../bootstrap/providers.ts'
 
 const exitCode = await runCli({
   argv: process.argv.slice(2),
-  defaultProviders: providers(),
+  defaultProviders: await providers(),
   app: createApp(),
 })
 

package/src/templates/shared/bootstrap/providers.ts

@@ -1,26 +1,21 @@
 import { HttpConsoleProvider, HttpProvider } from '@strav/http'
 import { ConfigProvider, LoggerProvider, type ServiceProvider } from '@strav/kernel'
 import { AppProvider } from '../app/providers/app_provider.ts'
-import appConfig from '../config/app.ts'
-import httpConfig from '../config/http.ts'
-import loggerConfig from '../config/logger.ts'
 
 /**
  * Default provider list. Order is not load-bearing — the container does a
  * dependency-aware topo sort at boot. Keep providers grouped by package
  * for readability.
  *
- * Adding more packages later (database, auth, queue, …)? Install the
- * package, add its config file under `config/`, register its `Config`
- * slot in `ConfigProvider` below, and append the provider to this list.
+ * `ConfigProvider.fromDirectory('config')` auto-discovers every
+ * `config/*.ts` file and keys them by basename — `config/app.ts` →
+ * `config('app.*')`, `config/http.ts` → `config('http.*')`, etc. To add
+ * a new config slot, drop a file with a `default export` into
+ * `config/`. No edits to this list required.
  */
-export function providers(): ServiceProvider[] {
+export async function providers(): Promise<ServiceProvider[]> {
   return [
-    new ConfigProvider({
-      app: appConfig,
-      http: httpConfig,
-      logger: loggerConfig,
-    }),
+    await ConfigProvider.fromDirectory('config'),
     new LoggerProvider(),
     new HttpProvider(),
     new HttpConsoleProvider(),

package/src/templates/web/bootstrap/providers.ts

@@ -2,28 +2,25 @@ import { HttpConsoleProvider, HttpProvider } from '@strav/http'
 import { ConfigProvider, LoggerProvider, type ServiceProvider } from '@strav/kernel'
 import { ViewConsoleProvider, ViewProvider } from '@strav/view'
 import { AppProvider } from '../app/providers/app_provider.ts'
-import appConfig from '../config/app.ts'
-import httpConfig from '../config/http.ts'
-import loggerConfig from '../config/logger.ts'
-import viewConfig from '../config/view.ts'
 
 /**
  * Default provider list. Order is not load-bearing — the container does a
  * dependency-aware topo sort at boot. Keep providers grouped by package
  * for readability.
  *
+ * `ConfigProvider.fromDirectory('config')` auto-discovers every
+ * `config/*.ts` file and keys them by basename — `config/view.ts` →
+ * `config('view.*')`, and so on. To add a new config slot, drop a file
+ * with a `default export` into `config/`. No edits to this list
+ * required.
+ *
  * `ViewProvider` discovers `.strav` files under `resources/views/pages/`
  * and registers a route for each at boot. `ViewConsoleProvider` adds the
  * `view:build` / `view:cache` / `view:clear` commands.
  */
-export function providers(): ServiceProvider[] {
+export async function providers(): Promise<ServiceProvider[]> {
   return [
-    new ConfigProvider({
-      app: appConfig,
-      http: httpConfig,
-      logger: loggerConfig,
-      view: viewConfig,
-    }),
+    await ConfigProvider.fromDirectory('config'),
     new LoggerProvider(),
     new HttpProvider(),
     new HttpConsoleProvider(),

package/src/templates/web/config/view.ts

@@ -4,8 +4,27 @@ import type { ViewConfig } from '@strav/view'
 export default {
   directory: 'resources/views',
   cache: env('APP_ENV', 'local') === 'production',
-  islandsDir: 'resources/ts/islands',
-  islandsOut: 'public/assets/islands',
+
+  // CSS bundling — `view:build` reads each input, walks `@import`s
+  // via Bun's CSS bundler, and writes to `outputDir`. The layout's
+  // `@css` directive emits the matching `<link rel="stylesheet">`.
+  css: {
+    inputs: ['resources/css/app.css'],
+    outputDir: 'public/assets',
+    linkPath: 'app.css',
+  },
+
+  // Asset versioning for `@asset` / `@css`. `publicDir` mirrors the
+  // layout under `/assets/...` so `app.css` resolves to a file at
+  // `public/assets/app.css` and a URL at `/assets/app.css`.
+  // Versioning is mtime-based by default; drop a
+  // `public/assets/manifest.json` to switch to fingerprinted
+  // filenames.
+  assets: {
+    publicDir: 'public/assets',
+    prefix: '/assets/',
+  },
+
   pages: {
     autoRoute: true,
   },

package/src/templates/web/resources/css/app.css

@@ -1,41 +1,32 @@
-/* Bare-bones starter styles. Swap for Tailwind, vanilla-extract, or your
- * stylesheet of choice — just point the <link rel="stylesheet"> in
- * `resources/views/layouts/app.strav` at the right built output. */
-
-:root {
-  --bg: #ffffff;
-  --fg: #111111;
-  --accent: #3b82f6;
-  font-family: system-ui, -apple-system, "Segoe UI", sans-serif;
-  line-height: 1.5;
-  color-scheme: light dark;
-}
-
-@media (prefers-color-scheme: dark) {
-  :root {
-    --bg: #0f0f10;
-    --fg: #f5f5f5;
-  }
-}
+/* Spring `--web` starter — vanilla CSS that pairs with the Tailwind
+ * CDN loaded by `resources/views/layouts/app.strav`. Everything below
+ * is what Tailwind doesn't cover: the body background grid, the
+ * fluid hero type, and the global text/background colour reset.
+ *
+ * Swap for your own stylesheet of choice — point the layout's `@css`
+ * directive (resolved via `config.view.css`) at whatever you build.
+ */
 
 body {
-  margin: 0;
-  background: var(--bg);
-  color: var(--fg);
+  background-color: #ffffff;
+  color: #000000;
 }
 
-main {
-  max-width: 48rem;
-  margin: 0 auto;
-  padding: 2rem 1.25rem;
+/* Faint red grid overlay across the page. The 40px cells line up
+ * with the Tailwind 8/12-step spacing rhythm. */
+.bg-grid-precision {
+  background-size: 40px 40px;
+  background-image:
+    linear-gradient(to right,  rgba(255, 68, 51, 0.05) 1px, transparent 1px),
+    linear-gradient(to bottom, rgba(255, 68, 51, 0.05) 1px, transparent 1px);
 }
 
-button {
-  cursor: pointer;
-  border-radius: 0.375rem;
-  border: 1px solid var(--accent);
-  background: var(--accent);
-  color: #fff;
-  padding: 0.5rem 1rem;
-  font: inherit;
+/* Fluid display type for the hero — clamps between 3rem at narrow
+ * widths and 5.5rem at wide. Letter-spacing tightens at scale; the
+ * line-height is sub-1 so the two stacked lines hug. */
+.text-huge {
+  font-size: clamp(3rem, 8vw, 5.5rem);
+  line-height: 0.95;
+  letter-spacing: -0.04em;
+  font-weight: 800;
 }

package/src/templates/web/resources/views/layouts/app.strav.tt

@@ -4,12 +4,43 @@
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1" />
   <title>@yield('title', '{{projectName}}')</title>
-  <link rel="stylesheet" href="/assets/app.css" />
+  <script src="https://cdn.tailwindcss.com?plugins=forms,container-queries"></script>
+  <script>
+    tailwind.config = {
+      theme: {
+        extend: {
+          colors: {
+            primary: '#ff4433',
+            'on-surface': '#000000',
+            'on-surface-variant': '#666666',
+            outline: '#e5e5e5',
+            surface: '#ffffff',
+          },
+          fontFamily: {
+            sans: ['system-ui', '-apple-system', 'sans-serif'],
+            mono: ['ui-monospace', 'SFMono-Regular', 'Menlo', 'Monaco', 'Consolas', 'monospace'],
+          },
+        },
+      },
+    }
+  </script>
+  @css
 </head>
-<body>
-  <main>
+<body class="min-h-screen flex flex-col selection:bg-primary selection:text-white bg-grid-precision">
+  <main class="flex-grow w-full mx-auto px-6 md:px-12 py-16 md:py-24 max-w-[800px]">
     @yield('content')
   </main>
-  <script type="module" src="/assets/islands/islands.js" defer></script>
+
+  <footer class="border-t border-black bg-white py-12 px-6 md:px-12 mt-auto">
+    <div class="max-w-[1400px] mx-auto flex flex-col md:flex-row justify-between items-center gap-8">
+      <div class="text-[10px] font-mono tracking-[0.3em] uppercase text-on-surface-variant">
+        © 2026 Strav
+      </div>
+      <div class="flex gap-12">
+        <a class="text-sm font-bold uppercase tracking-tighter hover:text-primary transition-colors" href="https://strav.dev">Docs</a>
+        <a class="text-sm font-bold uppercase tracking-tighter hover:text-primary transition-colors" href="https://github.com/strav/strav">Repository</a>
+      </div>
+    </div>
+  </footer>
 </body>
 </html>

package/src/templates/web/resources/views/pages/index.strav.tt

@@ -3,10 +3,45 @@
 @set('title', '{{projectName}}')
 
 @section('content')
-  <h1>Welcome to {{projectName}}</h1>
-  <p>You're looking at <code>resources/views/pages/index.strav</code>.</p>
+  {{-- Hero --}}
+  <div class="mb-24">
+    <div class="inline-block border border-primary px-3 py-1 mb-8 text-[11px] font-mono tracking-widest uppercase text-primary">
+      V1.0.0-AI • Local Environment Active
+    </div>
+    <h1 class="text-huge mb-8">
+      The Fast Path for<br>
+      <span class="text-primary">{{projectName}}</span>
+    </h1>
+    <p class="text-xl md:text-2xl text-on-surface-variant max-w-2xl leading-tight font-medium">
+      An industrial-grade architecture for modern web applications. Engineered for speed and the uncompromising developer.
+    </p>
+  </div>
 
-  <p>The button below is a Vue 3 island — see <code>resources/ts/islands/counter.vue</code>. Run <code>bun strav view:build</code> to compile islands into <code>public/assets/islands/</code>.</p>
+  {{-- Edit these to get started --}}
+  <div class="grid gap-0 border border-black bg-white">
+    <div class="p-8 md:p-12">
+      <h2 class="text-3xl font-bold tracking-tighter mb-8 italic">Edit these to get started</h2>
 
-  @island('Counter', { start: 0 })
+      <div class="flex flex-col divide-y divide-black/10 border-t border-black/10">
+        <div class="py-4 flex flex-col md:flex-row md:justify-between md:items-center gap-2 group">
+          <code class="font-mono text-primary group-hover:underline">resources/views/pages/index.strav</code>
+          <span class="text-[10px] font-mono uppercase text-on-surface-variant">This Page</span>
+        </div>
+        <div class="py-4 flex flex-col md:flex-row md:justify-between md:items-center gap-2">
+          <code class="font-mono text-black">resources/views/layouts/app.strav</code>
+          <span class="text-[10px] font-mono uppercase text-on-surface-variant">Layout Shell</span>
+        </div>
+        <div class="py-4 flex flex-col md:flex-row md:justify-between md:items-center gap-2">
+          <code class="font-mono text-black">resources/css/app.css</code>
+          <span class="text-[10px] font-mono uppercase text-on-surface-variant">Styles</span>
+        </div>
+      </div>
+
+      <div class="mt-12 flex flex-wrap gap-4">
+        <span class="text-[10px] font-mono font-bold px-2 py-1 border border-black">BUN</span>
+        <span class="text-[10px] font-mono font-bold px-2 py-1 border border-black">TYPESCRIPT</span>
+        <span class="text-[10px] font-mono font-bold px-2 py-1 border border-primary text-primary">POSTGRESQL</span>
+      </div>
+    </div>
+  </div>
 @endsection

package/src/version.ts

@@ -6,4 +6,4 @@
  * but this constant is what *generated apps* depend on — keep them in sync
  * on each release until spring formally cuts independent versions.
  */
-export const STRAV_VERSION = '^1.0.0-alpha.28'
+export const STRAV_VERSION = '^1.0.0-alpha.29'

package/src/templates/web/resources/ts/islands/counter.vue

@@ -1,11 +0,0 @@
-<script setup lang="ts">
-import { ref } from 'vue'
-
-const props = defineProps<{ start?: number }>()
-// biome-ignore lint/correctness/noUnusedVariables: bound by the <template> below
-const count = ref(props.start ?? 0)
-</script>
-
-<template>
-  <button @click="count++">Count is {{ count }}</button>
-</template>

package/src/templates/web/resources/ts/islands/setup.ts

@@ -1,13 +0,0 @@
-import type { App } from 'vue'
-
-/**
- * Shared setup for every Vue island on the page. Runs once on the single
- * `createApp(Root)` that the `@strav/view` islands bundler produces, so
- * plugins (Pinia, vue-router, i18n, …) and global directives go here.
- *
- * Export a default function. The bundler invokes it with the app instance.
- */
-export default (app: App): void => {
-  // Example: app.use(createPinia())
-  void app
-}