gemstack 0.2.5 → 0.3.0

data/templates/deploy/compose.yaml.tt

@@ -0,0 +1,129 @@
+# Runs <%= app_name %> in production mode on this machine, behind Caddy on https://localhost:
+#
+#   export SECRET_KEY_BASE=$(openssl rand -hex 64)<% if postgresql? %> POSTGRES_PASSWORD=$(openssl rand -hex 16)<% elsif mysql? %> MYSQL_PASSWORD=$(openssl rand -hex 16)<% end %>
+#   docker compose up --build
+#
+# It's also a map of what a real deploy needs: one image per process type,
+# migrations before the API starts, and a proxy sending /api to Ruby.
+<% if sqlite? -%>
+# SQLite: the database file lives on the `data` volume, shared by the API, the
+# jobs worker and migrations — keep them on one host.
+<% end -%>
+name: <%= app_name.tr("_", "-") %>
+
+x-api-env: &api-env
+  GEMSTACK_ENV: production
+  SECRET_KEY_BASE: ${SECRET_KEY_BASE:?set SECRET_KEY_BASE (openssl rand -hex 64)}
+<% if database? -%>
+  DATABASE_URL: <%= database_url %>
+<% end -%>
+<% if redis? -%>
+  REDIS_URL: redis://redis:6379/0 # realtime fan-out between the API and the jobs worker
+<% end -%>
+  APP_URL: ${APP_URL:-https://localhost}
+<% if mail? -%>
+  SMTP_URL: ${SMTP_URL:-}   # e.g. smtp://user:pass@smtp.example.com:587 — emails retry until it is set
+  MAIL_FROM: ${MAIL_FROM:-}
+<% end -%>
+
+services:
+<% if postgresql? -%>
+  db:
+    image: postgres:17
+    environment:
+      POSTGRES_USER: app
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?set POSTGRES_PASSWORD}
+      POSTGRES_DB: app
+    volumes: [db:/var/lib/postgresql/data]
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U app -d app"]
+      interval: 2s
+      retries: 30
+
+<% elsif mysql? -%>
+  db:
+    image: mysql:8.4
+    environment:
+      MYSQL_DATABASE: app
+      MYSQL_USER: app
+      MYSQL_PASSWORD: ${MYSQL_PASSWORD:?set MYSQL_PASSWORD}
+      MYSQL_RANDOM_ROOT_PASSWORD: "yes"
+    volumes: [db:/var/lib/mysql]
+    healthcheck:
+      test: ["CMD-SHELL", "mysqladmin ping -h 127.0.0.1 -uapp -p$$MYSQL_PASSWORD --silent"]
+      interval: 3s
+      retries: 40
+
+<% end -%>
+<% if redis? -%>
+  redis:
+    image: redis:7
+    command: ["redis-server", "--save", "", "--appendonly", "no"]
+
+<% end -%>
+<% if database? -%>
+  migrate:
+    image: <%= app_name %>-api
+    build: { context: ., target: api }
+    healthcheck: { disable: true }
+    command: ["bundle", "exec", "gemstack", "db:migrate"]
+    environment: *api-env
+<% if sqlite? -%>
+    volumes: [data:/data]
+<% else -%>
+    depends_on: { db: { condition: service_healthy } }
+<% end -%>
+
+<% end -%>
+  api:
+    image: <%= app_name %>-api
+    build: { context: ., target: api }
+    environment:
+      <<: *api-env
+      WEB_CONCURRENCY: ${WEB_CONCURRENCY:-2}
+<% if sqlite? -%>
+    volumes: [data:/data]
+<% end -%>
+<% if database? -%>
+    depends_on: { migrate: { condition: service_completed_successfully } }
+<% end -%>
+<% if jobs? -%>
+
+  jobs:
+    image: <%= app_name %>-api
+    build: { context: ., target: api }
+    healthcheck: { disable: true }
+    command: ["bundle", "exec", "gemstack", "jobs"]
+    environment: *api-env
+<% if sqlite? -%>
+    volumes: [data:/data]
+<% end -%>
+    depends_on: { migrate: { condition: service_completed_successfully } }
+<% end -%>
+<% if frontend? -%>
+
+  web:
+    image: <%= app_name %>-web
+    build: { context: ., target: web }
+    environment:
+      GEMSTACK_API_URL: http://api:4000 # Server Components call the API directly
+    depends_on: [api]
+<% end -%>
+
+  proxy:
+    image: caddy:2
+    ports: ["80:80", "443:443"]
+    environment:
+      SITE_ADDRESS: ${SITE_ADDRESS:-localhost}
+    volumes:
+      - ./Caddyfile:/etc/caddy/Caddyfile:ro
+      - caddy:/data
+    depends_on: [api<%= ", web" if frontend? %>]
+
+volumes:
+<% if sqlite? -%>
+  data:
+<% elsif database? -%>
+  db:
+<% end -%>
+  caddy:

data/templates/deploy/dot_dockerignore

@@ -0,0 +1,14 @@
+# Kept out of the build context (and so out of images).
+.git
+.env
+.env.*
+!.env.example
+tmp/
+log/
+storage/
+coverage/
+node_modules/
+frontend/node_modules/
+frontend/.next/
+**/*.pem
+**/*.key

data/templates/frontend/app/globals.css

@@ -0,0 +1,171 @@
+:root {
+  --bg: #ffffff;
+  --fg: #16181d;
+  --muted: #5b6170;
+  --code-bg: #f1f2f5;
+  --ok: #1f9d55;
+  --error: #d64545;
+  --pending: #d99a1e;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --bg: #0f1115;
+    --fg: #e6e8ee;
+    --muted: #9aa0ad;
+    --code-bg: #1c2030;
+  }
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  background: var(--bg);
+  color: var(--fg);
+  font: 16px/1.6 system-ui, -apple-system, "Segoe UI", sans-serif;
+}
+
+code {
+  background: var(--code-bg);
+  padding: 0.1rem 0.35rem;
+  border-radius: 4px;
+  font-size: 0.9em;
+}
+
+.page {
+  max-width: 40rem;
+  margin: 0 auto;
+  padding: 4rem 1rem;
+}
+
+.muted {
+  color: var(--muted);
+}
+
+.status {
+  display: flex;
+  align-items: center;
+  gap: 0.6rem;
+  padding: 0.75rem 1rem;
+  border-radius: 8px;
+  background: var(--code-bg);
+}
+
+.dot {
+  width: 0.6rem;
+  height: 0.6rem;
+  border-radius: 50%;
+  flex: none;
+}
+
+.status-ok .dot {
+  background: var(--ok);
+}
+
+.status-error .dot {
+  background: var(--error);
+}
+
+.status-pending .dot {
+  background: var(--pending);
+}
+
+a {
+  color: inherit;
+}
+
+h1 {
+  margin-top: 0;
+}
+
+.page-header,
+.actions {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1rem;
+}
+
+.actions {
+  justify-content: flex-start;
+  margin-top: 1.5rem;
+}
+
+.button {
+  display: inline-block;
+  padding: 0.45rem 0.9rem;
+  border: 1px solid var(--fg);
+  border-radius: 6px;
+  background: var(--fg);
+  color: var(--bg);
+  font: inherit;
+  text-decoration: none;
+  cursor: pointer;
+}
+
+.button:disabled {
+  opacity: 0.6;
+  cursor: default;
+}
+
+.button-danger {
+  background: var(--error);
+  border-color: var(--error);
+  color: #fff;
+}
+
+.table {
+  width: 100%;
+  border-collapse: collapse;
+}
+
+.table th,
+.table td {
+  padding: 0.5rem;
+  border-bottom: 1px solid var(--code-bg);
+  text-align: left;
+}
+
+.form {
+  display: grid;
+  gap: 1rem;
+  max-width: 32rem;
+}
+
+.field {
+  display: grid;
+  gap: 0.3rem;
+}
+
+.field input:not([type="checkbox"]),
+.field textarea {
+  padding: 0.45rem;
+  border: 1px solid var(--muted);
+  border-radius: 6px;
+  background: var(--bg);
+  color: var(--fg);
+  font: inherit;
+}
+
+.field-error,
+.form-error {
+  margin: 0;
+  color: var(--error);
+}
+
+.card {
+  display: grid;
+  grid-template-columns: max-content 1fr;
+  gap: 0.4rem 1.5rem;
+}
+
+.card dt {
+  color: var(--muted);
+}
+
+.card dd {
+  margin: 0;
+}

data/templates/frontend/app/layout.tsx.tt

@@ -0,0 +1,19 @@
+import type { Metadata } from "next";
+import type { ReactNode } from "react";
+import { Providers } from "./providers";
+import "./globals.css";
+
+export const metadata: Metadata = {
+  title: "<%= module_name %>",
+  description: "A GemStack application",
+};
+
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return (
+    <html lang="en">
+      <body>
+        <Providers>{children}</Providers>
+      </body>
+    </html>
+  );
+}

data/templates/frontend/app/page.module.css

@@ -0,0 +1,315 @@
+/* The GemStack welcome page (app/page.tsx). Delete both files when you replace it. */
+
+.shell {
+  --ruby: #e11d48;
+  --violet: #7c3aed;
+  --ink: #16181d;
+  --muted: #5b6170;
+  --surface: rgba(255, 255, 255, 0.72);
+  --border: rgba(22, 24, 29, 0.09);
+  --code: #f3f4f7;
+  --ok: #16a34a;
+  --pending: #d99a1e;
+  --error: #dc2626;
+
+  min-height: 100vh;
+  display: flex;
+  flex-direction: column;
+  color: var(--ink);
+  background:
+    radial-gradient(60rem 30rem at 10% -10%, rgba(225, 29, 72, 0.12), transparent 60%),
+    radial-gradient(50rem 30rem at 100% 0%, rgba(124, 58, 237, 0.12), transparent 60%),
+    #fbfbfd;
+}
+
+@media (prefers-color-scheme: dark) {
+  .shell {
+    --ink: #eceef4;
+    --muted: #9aa0ad;
+    --surface: rgba(24, 27, 36, 0.72);
+    --border: rgba(255, 255, 255, 0.08);
+    --code: rgba(255, 255, 255, 0.06);
+    --ok: #4ade80;
+    --pending: #fbbf24;
+    --error: #f87171;
+
+    background:
+      radial-gradient(60rem 30rem at 10% -10%, rgba(225, 29, 72, 0.22), transparent 60%),
+      radial-gradient(50rem 30rem at 100% 0%, rgba(124, 58, 237, 0.22), transparent 60%),
+      #0c0d12;
+  }
+}
+
+.main {
+  flex: 1;
+  width: 100%;
+  max-width: 68rem;
+  margin: 0 auto;
+  padding: clamp(3rem, 8vw, 6rem) 1.25rem 3rem;
+}
+
+/* Hero */
+
+.hero {
+  text-align: center;
+  margin-bottom: clamp(2.5rem, 6vw, 4rem);
+}
+
+.logo {
+  width: 5rem;
+  height: 5rem;
+  filter: drop-shadow(0 12px 24px rgba(225, 29, 72, 0.35));
+  animation: float 6s ease-in-out infinite;
+}
+
+@keyframes float {
+  50% {
+    transform: translateY(-6px) rotate(-2deg);
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .logo {
+    animation: none;
+  }
+}
+
+.eyebrow {
+  margin: 1rem 0 0.5rem;
+  font-size: 0.8rem;
+  font-weight: 700;
+  letter-spacing: 0.18em;
+  text-transform: uppercase;
+  color: var(--muted);
+}
+
+.title {
+  margin: 0;
+  font-size: clamp(2.2rem, 6vw, 3.6rem);
+  line-height: 1.1;
+  letter-spacing: -0.03em;
+  font-weight: 800;
+}
+
+.accent {
+  background: linear-gradient(120deg, #ff5f8f, var(--ruby) 45%, var(--violet));
+  -webkit-background-clip: text;
+  background-clip: text;
+  color: transparent;
+}
+
+.lead {
+  max-width: 38rem;
+  margin: 1.1rem auto 0;
+  font-size: clamp(1.02rem, 2.2vw, 1.2rem);
+  color: var(--muted);
+}
+
+.lead strong {
+  color: var(--ink);
+}
+
+/* Live checks */
+
+.checks {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: center;
+  gap: 0.6rem;
+  margin-top: 2rem;
+}
+
+.check {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.55rem;
+  padding: 0.5rem 0.95rem;
+  border: 1px solid var(--border);
+  border-radius: 999px;
+  background: var(--surface);
+  backdrop-filter: blur(8px);
+  font-size: 0.92rem;
+  overflow-wrap: anywhere;
+}
+
+.check code {
+  font-size: 0.85em;
+}
+
+.dot {
+  width: 0.55rem;
+  height: 0.55rem;
+  flex: none;
+  border-radius: 50%;
+  background: currentColor;
+}
+
+.ok .dot {
+  background: var(--ok);
+  box-shadow: 0 0 0 4px color-mix(in srgb, var(--ok) 22%, transparent);
+}
+
+.pending .dot {
+  background: var(--pending);
+  animation: pulse 1.2s ease-in-out infinite;
+}
+
+.error .dot {
+  background: var(--error);
+}
+
+@keyframes pulse {
+  50% {
+    opacity: 0.35;
+  }
+}
+
+/* Cards */
+
+.grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(15rem, 1fr));
+  gap: 1rem;
+}
+
+.card {
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  gap: 0.6rem;
+  padding: 1.4rem;
+  border: 1px solid var(--border);
+  border-radius: 16px;
+  background: var(--surface);
+  backdrop-filter: blur(8px);
+  transition:
+    transform 0.2s ease,
+    border-color 0.2s ease,
+    box-shadow 0.2s ease;
+}
+
+.card:hover {
+  transform: translateY(-2px);
+  border-color: color-mix(in srgb, var(--ruby) 35%, var(--border));
+  box-shadow: 0 16px 40px -24px rgba(225, 29, 72, 0.45);
+}
+
+.step {
+  display: grid;
+  place-items: center;
+  width: 1.9rem;
+  height: 1.9rem;
+  border-radius: 10px;
+  background: linear-gradient(135deg, var(--ruby), var(--violet));
+  color: #fff;
+  font-size: 0.85rem;
+  font-weight: 700;
+}
+
+.cardTitle {
+  margin: 0.3rem 0 0;
+  font-size: 1.08rem;
+}
+
+.cardText {
+  flex: 1;
+  margin: 0;
+  color: var(--muted);
+  font-size: 0.93rem;
+  line-height: 1.5;
+}
+
+.command {
+  display: flex;
+  align-items: flex-start;
+  gap: 0.5rem;
+  padding: 0.55rem 0.6rem 0.55rem 0.8rem;
+  border-radius: 10px;
+  background: var(--code);
+  font-size: 0.82rem;
+}
+
+.command code {
+  flex: 1;
+  min-width: 0;
+  padding: 0.15rem 0 0;
+  background: none;
+  line-height: 1.5;
+  overflow-wrap: anywhere; /* long commands wrap instead of being cut off */
+}
+
+.prompt {
+  color: var(--ruby);
+  user-select: none;
+}
+
+.copy {
+  flex: none;
+  padding: 0.25rem 0.6rem;
+  border: 1px solid var(--border);
+  border-radius: 7px;
+  background: transparent;
+  color: var(--ink);
+  font: inherit;
+  font-size: 0.75rem;
+  cursor: pointer;
+}
+
+.copy:hover,
+.copy:focus-visible {
+  border-color: var(--ruby);
+  color: var(--ruby);
+}
+
+.link {
+  align-self: flex-start;
+  color: var(--ruby);
+  font-weight: 600;
+  text-decoration: none;
+}
+
+.link:hover,
+.link:focus-visible {
+  text-decoration: underline;
+}
+
+.edit {
+  margin: 2.5rem 0 0;
+  text-align: center;
+  color: var(--muted);
+  font-size: 0.92rem;
+}
+
+/* Footer */
+
+.footer {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: space-between;
+  gap: 0.5rem 1.5rem;
+  width: 100%;
+  max-width: 68rem;
+  margin: 0 auto;
+  padding: 1.5rem 1.25rem 2rem;
+  border-top: 1px solid var(--border);
+  color: var(--muted);
+  font-size: 0.85rem;
+}
+
+.footer a {
+  color: var(--ink);
+  font-weight: 600;
+  text-decoration: none;
+}
+
+.footer a:hover,
+.footer a:focus-visible {
+  color: var(--ruby);
+}
+
+@media (max-width: 40rem) {
+  .footer {
+    justify-content: center;
+    text-align: center;
+  }
+}