gemstack-cli 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d9243d3986f9d45d5aa9de84f699ea7fcac37504ed266d7998e5a4eab6ff484
-  data.tar.gz: 6cf9300583fb65e103c7b71b48859721863766837180a362365639ec0186c5fc
+  metadata.gz: 8f9ebe8567d9943d054f3baaf1427483fd75242677bc8a461034d63a826b197e
+  data.tar.gz: 816d6520c304822b290f30b417f574dfe8bd771586d5bc8a6df2b929ec144b4f
 SHA512:
-  metadata.gz: 54009542d20d3bcc5ae67e2b89e19965c285e32b6400ca43e7ecf22af1f2bc3a8303803c2c1708cc967f5c50fed4c159e7807e5f41bdb9da702c87f9cc4e8229
-  data.tar.gz: 0acb8e759970a5154f11fae58d530c960575849ec4f93018f46b9a8ef70f1d43cfac289c0606ae16508efd16f843ade368b0fa49777e15caacdb42e42e9db22a
+  metadata.gz: 7068ec73cee6b4f0e87cb5c84a4f0531bbfd8444df9170a994e6223f8a32cf7d5b814ef089bc5c5854ce539e919bc9a5dde10118dcfcd035ac02099bff5e5e28
+  data.tar.gz: f1c8ddf36a3b0eb81f7a1a680b5c95bfa8df8328dbbf0804f927bfb85339f02fba020cb6e8d66e16f0c14fff3902a2183bd49a212dc1a39bf3ce650365b55b62

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.2.2
+
+See the [GemStack changelog](https://github.com/gemstack-rb/gemstack/blob/main/CHANGELOG.md).
+
 ## 0.2.1
 
 See the [GemStack changelog](https://github.com/gemstack-rb/gemstack/blob/main/CHANGELOG.md).

data/LICENSE.txt

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Shoaib Malik
+Copyright (c) 2026 Adware Technologies (https://www.adwaretech.com)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -3,7 +3,7 @@
 GemStack command-line interface and generators.
 
 Part of [GemStack](https://github.com/gemstack-rb/gemstack), a modular Ruby API framework for Next.js
-applications. All GemStack gems are developed together in that repository and released with the same
+applications by [Adware Technologies](https://www.adwaretech.com). All GemStack gems are developed together in that repository and released with the same
 version.
 
 ## Installation
@@ -21,4 +21,4 @@ Source, issues and pull requests: [gemstack-rb/gemstack](https://github.com/gems
 
 ## License
 
-MIT — see [LICENSE.txt](LICENSE.txt).
+Open source under the MIT License — © [Adware Technologies](https://www.adwaretech.com). See [LICENSE.txt](LICENSE.txt).

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;
+  }
+}

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

@@ -1,45 +1,183 @@
 "use client";
 
 import { useQuery } from "@tanstack/react-query";
+import { useState } from "react";
 import { api, API_PATH } from "@/lib/gemstack/client";
+import styles from "./page.module.css";
 
-// Starter page: confirms the browser reaches the Ruby API through the same origin.
-// Replace it with your application.
-export default function Home() {
+// The GemStack welcome page: shows that Next.js renders and that the browser
+// reaches the Ruby API through the same origin. Replace it with your app —
+// this file and app/page.module.css are yours to delete.
+
+const DOCS = "https://github.com/gemstack-rb/gemstack/tree/main/docs";
+
+export default function Welcome() {
   const health = useQuery({
-    queryKey: ["health"],
-    queryFn: () => api.get<{ status: string }>("/health"),
+    queryKey: ["gemstack", "health"],
+    queryFn: async () => {
+      const started = performance.now();
+      const body = await api.get<{ status: string }>("/health");
+      return { ...body, ms: Math.round(performance.now() - started) };
+    },
+    retry: 1,
   });
+  const apiState = health.isPending ? "pending" : health.isError ? "error" : "ok";
+
+  return (
+    <div className={styles.shell}>
+      <main className={styles.main}>
+        <header className={styles.hero}>
+          <GemLogo className={styles.logo} />
+          <p className={styles.eyebrow}>GemStack</p>
+          <h1 className={styles.title}>
+            Yay! You&apos;re on <span className={styles.accent}>GemStack</span>.
+          </h1>
+          <p className={styles.lead}>
+            <strong><%= module_name %></strong> is running: a Next.js frontend and a Ruby API, served from one origin.
+          </p>
+
+          <div className={styles.checks} role="status" aria-live="polite">
+            <span className={`${styles.check} ${styles.ok}`}>
+              <span className={styles.dot} aria-hidden="true" /> Next.js rendering
+            </span>
+            <span className={`${styles.check} ${styles[apiState]}`}>
+              <span className={styles.dot} aria-hidden="true" />
+              {apiState === "pending" && "Connecting to the Ruby API…"}
+              {apiState === "ok" && (
+                <>
+                  Ruby API connected · <code>GET {API_PATH}/health</code> in {health.data?.ms} ms
+                </>
+              )}
+              {apiState === "error" && <>Ruby API unreachable: {health.error?.message}</>}
+            </span>
+          </div>
+        </header>
 
-  const state = health.isPending ? "pending" : health.isError ? "error" : "ok";
-  const label = {
-    pending: "Connecting to the Ruby API…",
-    error: `Ruby API unreachable: ${health.error?.message}`,
-    ok: `Ruby API connected — GET ${API_PATH}/health → ${health.data?.status}`,
-  }[state];
+        <section className={styles.grid} aria-label="Next steps">
+          <Card
+            step="1"
+            title="Generate a resource"
+            text="Migration, model, API, typed TypeScript client and Next.js pages — in one command."
+            command="gemstack g resource Product name:string"
+          />
+          <Card
+            step="2"
+            title="Explore your API"
+            text="Every endpoint with its types, and a form to try requests from the browser."
+            href={`${API_PATH}/docs`}
+            linkLabel={`Open ${API_PATH}/docs`}
+          />
+          <Card
+            step="3"
+            title="Check your setup"
+            text="Ruby, Node.js, the database, migrations and the TypeScript contract — with the fix for anything off."
+            command="gemstack doctor"
+          />
+          <Card
+            step="4"
+            title="Read the guides"
+            text="Models, controllers, jobs, realtime, authentication, storage and deployment."
+            href={DOCS}
+            linkLabel="Open the guides"
+            external
+          />
+        </section>
+
+        <p className={styles.edit}>
+          Edit <code>frontend/app/page.tsx</code> to replace this page · API code lives in <code>app/</code>
+        </p>
+      </main>
+
+      <footer className={styles.footer}>
+        <span>
+          GemStack <%= version %> · Ruby <%= ruby_version %> · Next.js
+        </span>
+        <span>
+          Open source by{" "}
+          <a href="https://www.adwaretech.com" target="_blank" rel="noreferrer">
+            Adware Technologies
+          </a>
+        </span>
+      </footer>
+    </div>
+  );
+}
+
+function Card(props: {
+  step: string;
+  title: string;
+  text: string;
+  command?: string;
+  href?: string;
+  linkLabel?: string;
+  external?: boolean;
+}) {
+  return (
+    <article className={styles.card}>
+      <span className={styles.step} aria-hidden="true">
+        {props.step}
+      </span>
+      <h2 className={styles.cardTitle}>{props.title}</h2>
+      <p className={styles.cardText}>{props.text}</p>
+      {props.command && <Command text={props.command} />}
+      {props.href && (
+        <a
+          className={styles.link}
+          href={props.href}
+          {...(props.external ? { target: "_blank", rel: "noreferrer" } : {})}
+        >
+          {props.linkLabel} <span aria-hidden="true">→</span>
+        </a>
+      )}
+    </article>
+  );
+}
+
+function Command({ text }: { text: string }) {
+  const [copied, setCopied] = useState(false);
+  async function copy() {
+    try {
+      await navigator.clipboard.writeText(text);
+      setCopied(true);
+      setTimeout(() => setCopied(false), 1500);
+    } catch {
+      // Clipboard unavailable (e.g. not a secure context): the command stays selectable.
+    }
+  }
+  return (
+    <div className={styles.command}>
+      <code>
+        <span className={styles.prompt} aria-hidden="true">
+          $
+        </span>{" "}
+        {text}
+      </code>
+      <button type="button" className={styles.copy} onClick={copy} aria-label={`Copy: ${text}`}>
+        {copied ? "Copied" : "Copy"}
+      </button>
+    </div>
+  );
+}
 
+function GemLogo({ className }: { className?: string }) {
   return (
-    <main className="page">
-      <h1><%= module_name %></h1>
-      <p className="muted">Next.js + TypeScript frontend, GemStack Ruby API, one origin.</p>
-
-      <p className={`status status-${state}`} role="status">
-        <span className="dot" aria-hidden="true" />
-        {label}
-      </p>
-
-      <h2>Next steps</h2>
-      <ul>
-        <li>
-          Add an endpoint: <code>gemstack generate controller Status show</code>
-        </li>
-        <li>
-          Call it from here: <code>api.get(&quot;/status/1&quot;)</code> (see <code>lib/gemstack/client.ts</code>)
-        </li>
-        <li>
-          Edit this page: <code>frontend/app/page.tsx</code>
-        </li>
-      </ul>
-    </main>
+    <svg className={className} viewBox="0 0 64 64" role="img" aria-label="GemStack">
+      <defs>
+        <linearGradient id="gemstack-gem" x1="0" y1="0" x2="1" y2="1">
+          <stop offset="0" stopColor="#ff5f8f" />
+          <stop offset="0.55" stopColor="#e11d48" />
+          <stop offset="1" stopColor="#7c3aed" />
+        </linearGradient>
+      </defs>
+      <path d="M18 8h28l12 15-26 34L6 23z" fill="url(#gemstack-gem)" />
+      <path
+        d="M6 23h52M18 8l7 15 7-15 7 15 7-15M25 23l7 34 7-34"
+        fill="none"
+        stroke="rgba(255,255,255,0.55)"
+        strokeWidth="1.4"
+        strokeLinejoin="round"
+      />
+      <path d="M18 8h28l-7 15H25z" fill="rgba(255,255,255,0.18)" />
+    </svg>
   );
 }

metadata

@@ -1,9 +1,10 @@
 --- !ruby/object:Gem::Specification
 name: gemstack-cli
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
+- Adware Technologies
 - Shoaib Malik
 bindir: exe
 cert_chain: []
@@ -15,28 +16,28 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.1
+        version: 0.2.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.1
+        version: 0.2.2
 - !ruby/object:Gem::Dependency
   name: gemstack-dev
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.1
+        version: 0.2.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.1
+        version: 0.2.2
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
@@ -139,6 +140,7 @@ files:
 - templates/deploy/dot_dockerignore
 - templates/frontend/app/globals.css
 - templates/frontend/app/layout.tsx.tt
+- templates/frontend/app/page.module.css
 - templates/frontend/app/page.tsx.tt
 - templates/frontend/app/providers.tsx
 - templates/frontend/lib/gemstack/client.ts