create-githat-app 1.0.15 → 1.0.16

package/templates/classroom/app/page.tsx.hbs

@@ -0,0 +1,103 @@
+'use client';
+
+import Link from 'next/link';
+import { useAuth, SignInButton } from '@githat/nextjs';
+
+/**
+ * Classroom — projects with real-world feedback.
+ *
+ * Built for students (and anyone presenting work-in-progress) to
+ * replace the dead-end PDF. You upload a project, share a link,
+ * and audience feedback streams in as you present. The work
+ * iterates — every cohort that hits the same project sees the
+ * latest version and adds to it.
+ *
+ * The flagship feature is /projects/[id]/present + /projects/[id]/feedback —
+ * presenter sees responses live, audience submits without an account.
+ *
+ * Why this matters: a portfolio of dead PDFs is worth less than
+ * a single project with a year of audience feedback layered on top.
+ */
+const SAMPLE_PROJECTS = [
+  { id: 'sustainable-bodega', title: 'Sustainable bodega supply chain', author: 'Maria L.', cohort: 'Spring 2026', responses: 47 },
+  { id: 'after-school-tutor',  title: 'After-school tutor matching app', author: 'Devon R.',  cohort: 'Spring 2026', responses: 12 },
+  { id: 'community-fridge',    title: 'Community fridge tracker',         author: 'Aisha M.',  cohort: 'Fall 2025',   responses: 89 },
+];
+
+export default function Home() {
+  const { isSignedIn } = useAuth();
+
+  return (
+    <div style=\{{ background: 'var(--bg)', color: 'var(--fg)' }}>
+      <section style=\{{
+        padding: 'var(--space-12) var(--space-4)',
+        textAlign: 'center',
+        maxWidth: '40rem',
+        margin: '0 auto',
+      }}>
+        <h1 style=\{{
+          fontFamily: 'var(--font-wordmark, Georgia, serif)',
+          fontSize: 'clamp(2rem, 5vw, 3rem)',
+          lineHeight: 1.1,
+          marginBottom: 'var(--space-3)',
+        }}>
+          {{businessName}}
+        </h1>
+        <p style=\{{ color: 'var(--fg-muted)', fontSize: '1.125rem', lineHeight: 1.6, marginBottom: 'var(--space-6)' }}>
+          Show your work. Get real feedback as you present. Watch
+          your project iterate over time — each cohort that visits
+          adds to it.
+          <br />
+          <em style=\{{ fontSize: '0.875rem' }}>The PDF is dead. Long live the living project.</em>
+        </p>
+        {!isSignedIn ? (
+          <SignInButton />
+        ) : (
+          <Link href="/admin" style=\{{
+            display: 'inline-block',
+            padding: 'var(--space-3) var(--space-6)',
+            borderRadius: 'var(--radius-md, 0.5rem)',
+            background: 'var(--primary)',
+            color: 'var(--bg)',
+            fontWeight: 600,
+            textDecoration: 'none',
+          }}>
+            New project →
+          </Link>
+        )}
+      </section>
+
+      <section style=\{{ padding: 'var(--space-8) var(--space-4)', maxWidth: '48rem', margin: '0 auto' }}>
+        <h2 style=\{{ fontSize: '1.5rem', marginBottom: 'var(--space-4)' }}>Live projects</h2>
+        <p style=\{{ color: 'var(--fg-muted)', fontSize: '0.875rem', marginBottom: 'var(--space-4)' }}>
+          Anyone can submit feedback — no account required. Authors
+          see responses streaming in as they present.
+        </p>
+        <ul style=\{{ listStyle: 'none', padding: 0, margin: 0, display: 'flex', flexDirection: 'column', gap: 'var(--space-3)' }}>
+          {SAMPLE_PROJECTS.map((p) => (
+            <li key={p.id}>
+              <Link href={`/projects/${p.id}`} style=\{{
+                display: 'block',
+                padding: 'var(--space-5)',
+                borderRadius: 'var(--radius-md, 0.5rem)',
+                border: '1px solid var(--border)',
+                background: 'var(--surface)',
+                color: 'var(--fg)',
+                textDecoration: 'none',
+              }}>
+                <h3 style=\{{ fontSize: '1.125rem', fontWeight: 600, marginBottom: 'var(--space-1)' }}>{p.title}</h3>
+                <div style=\{{ fontSize: '0.875rem', color: 'var(--fg-muted)', display: 'flex', gap: 'var(--space-3)', flexWrap: 'wrap' }}>
+                  <span>{p.author}</span>
+                  <span>·</span>
+                  <span>{p.cohort}</span>
+                  <span>·</span>
+                  <span><strong>{p.responses}</strong> responses</span>
+                </div>
+              </Link>
+            </li>
+          ))}
+        </ul>
+      </section>
+    </div>
+  );
+}

package/templates/classroom/app/projects/[id]/feedback/page.tsx.hbs

@@ -0,0 +1,159 @@
+'use client';
+
+import { use, useState } from 'react';
+import Link from 'next/link';
+
+/**
+ * Audience feedback form — `/projects/[id]/feedback`.
+ *
+ * Anyone with the link can fill this out. NO sign-in required —
+ * that's the whole point. Anonymous responses go to a queue the
+ * presenter watches in real time on /present.
+ *
+ * The form questions are deliberately short — long forms kill
+ * response rates and the value of this template is volume of
+ * feedback over time, not depth per response.
+ */
+export default function FeedbackPage({ params }: { params: Promise<{ id: string }> }) {
+  const { id } = use(params);
+  const [submitted, setSubmitted] = useState(false);
+  const [oneThing, setOneThing] = useState('');
+  const [stuck, setStuck] = useState('');
+  const [scale, setScale] = useState(7);
+
+  if (submitted) {
+    return (
+      <div style=\{{
+        background: 'var(--bg)',
+        color: 'var(--fg)',
+        minHeight: 'calc(100vh - 64px)',
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        padding: 'var(--space-4)',
+      }}>
+        <div style=\{{ maxWidth: '32rem', textAlign: 'center' }}>
+          <h1 style=\{{ fontFamily: 'var(--font-wordmark)', fontSize: '2rem', marginBottom: 'var(--space-3)' }}>
+            ¡Gracias!
+          </h1>
+          <p style=\{{ color: 'var(--fg-muted)', marginBottom: 'var(--space-4)' }}>
+            The presenter sees your feedback live on their screen.
+            You can submit again with a new thought any time.
+          </p>
+          <button
+            onClick={() => { setSubmitted(false); setOneThing(''); setStuck(''); setScale(7); }}
+            style=\{{
+              padding: 'var(--space-3) var(--space-5)',
+              borderRadius: 'var(--radius-md, 0.5rem)',
+              background: 'var(--primary)',
+              color: 'var(--bg)',
+              border: 'none',
+              fontWeight: 600,
+              cursor: 'pointer',
+            }}
+          >
+            Add another thought
+          </button>
+        </div>
+      </div>
+    );
+  }
+
+  return (
+    <div style=\{{ background: 'var(--bg)', color: 'var(--fg)', minHeight: 'calc(100vh - 64px)', padding: 'var(--space-8) var(--space-4)' }}>
+      <div style=\{{ maxWidth: '32rem', margin: '0 auto' }}>
+        <Link href={`/projects/${id}`} style=\{{ color: 'var(--fg-muted)', fontSize: '0.875rem', display: 'inline-block', marginBottom: 'var(--space-4)' }}>
+          ← Project
+        </Link>
+        <h1 style=\{{ fontFamily: 'var(--font-wordmark)', fontSize: '1.75rem', marginBottom: 'var(--space-2)' }}>
+          Tell them what you think
+        </h1>
+        <p style=\{{ color: 'var(--fg-muted)', marginBottom: 'var(--space-6)' }}>
+          No account, no email. Just three quick questions while
+          they're presenting.
+        </p>
+
+        <form
+          onSubmit={(e) => {
+            e.preventDefault();
+            /* TODO: POST /api/projects/[id]/feedback { oneThing, stuck, scale } */
+            setSubmitted(true);
+          }}
+          style=\{{ display: 'flex', flexDirection: 'column', gap: 'var(--space-5)' }}
+        >
+          <Field label="One thing that landed for you">
+            <input
+              type="text"
+              required
+              value={oneThing}
+              onChange={(e) => setOneThing(e.target.value)}
+              placeholder="The thing you'll remember tomorrow"
+              style=\{{
+                width: '100%',
+                padding: 'var(--space-3)',
+                borderRadius: 'var(--radius-md, 0.5rem)',
+                border: '1px solid var(--border)',
+                background: 'var(--surface)',
+                color: 'var(--fg)',
+                fontSize: '1rem',
+              }}
+            />
+          </Field>
+
+          <Field label="One thing you'd want them to dig into more">
+            <textarea
+              value={stuck}
+              onChange={(e) => setStuck(e.target.value)}
+              rows={3}
+              placeholder="A question, a doubt, a what-if"
+              style=\{{
+                width: '100%',
+                padding: 'var(--space-3)',
+                borderRadius: 'var(--radius-md, 0.5rem)',
+                border: '1px solid var(--border)',
+                background: 'var(--surface)',
+                color: 'var(--fg)',
+                fontSize: '1rem',
+                fontFamily: 'inherit',
+                resize: 'vertical',
+              }}
+            />
+          </Field>
+
+          <Field label={`How likely are you to share this with someone? (${scale}/10)`}>
+            <input
+              type="range"
+              min={1}
+              max={10}
+              value={scale}
+              onChange={(e) => setScale(Number(e.target.value))}
+              style=\{{ width: '100%' }}
+            />
+          </Field>
+
+          <button type="submit" style=\{{
+            padding: 'var(--space-3) var(--space-5)',
+            borderRadius: 'var(--radius-md, 0.5rem)',
+            background: 'var(--primary)',
+            color: 'var(--bg)',
+            border: 'none',
+            fontWeight: 600,
+            fontSize: '1rem',
+            cursor: 'pointer',
+          }}>
+            Send feedback
+          </button>
+        </form>
+      </div>
+    </div>
+  );
+}
+
+function Field({ label, children }: { label: string; children: React.ReactNode }) {
+  return (
+    <label style=\{{ display: 'flex', flexDirection: 'column', gap: 'var(--space-2)' }}>
+      <span style=\{{ fontSize: '0.875rem', fontWeight: 600 }}>{label}</span>
+      {children}
+    </label>
+  );
+}

package/templates/classroom/app/projects/[id]/present/page.tsx.hbs

@@ -0,0 +1,113 @@
+'use client';
+
+import { use, useEffect, useState } from 'react';
+
+/**
+ * Presenter view — `/projects/[id]/present`.
+ *
+ * The student opens this on their second screen (or a phone next
+ * to the laptop) and presents. As the audience submits feedback
+ * via /projects/[id]/feedback, responses fade in here in real
+ * time — newest first, color-coded by the scale rating.
+ *
+ * Real implementations:
+ *  - Replace the mock interval with a polling fetch (every 3-5s)
+ *    against your backend, OR a websocket / SSE stream.
+ *  - Persist responses to your DB so the project can reiterate
+ *    over multiple cohorts.
+ */
+
+interface FeedbackEntry {
+  id: string;
+  oneThing: string;
+  stuck: string;
+  scale: number;
+  receivedAt: number;
+}
+
+const MOCK_FEEDBACK: FeedbackEntry[] = [
+  { id: 'a', oneThing: 'The slide on supply chain bottlenecks', stuck: 'How do you measure trust at scale?', scale: 9, receivedAt: Date.now() - 60_000 },
+  { id: 'b', oneThing: 'Loved the bilingual UX argument',       stuck: 'What about Mexican misceláneas?',     scale: 8, receivedAt: Date.now() - 120_000 },
+];
+
+export default function PresenterPage({ params }: { params: Promise<{ id: string }> }) {
+  const { id } = use(params);
+  const [feedback, setFeedback] = useState<FeedbackEntry[]>(MOCK_FEEDBACK);
+
+  // Simulated incoming feedback. Replace with a real fetch poll or
+  // websocket subscription. The shape is the same.
+  useEffect(() => {
+    const t = setInterval(() => {
+      // setFeedback((prev) => [{ ...newOne, id: crypto.randomUUID() }, ...prev]);
+    }, 5000);
+    return () => clearInterval(t);
+  }, []);
+
+  const audienceUrl = typeof window !== 'undefined'
+    ? `${window.location.origin}/projects/${id}/feedback`
+    : `/projects/${id}/feedback`;
+
+  return (
+    <div style=\{{ background: 'var(--bg)', color: 'var(--fg)', minHeight: '100vh', padding: 'var(--space-6) var(--space-4)' }}>
+      <div style=\{{ maxWidth: '64rem', margin: '0 auto' }}>
+        <header style=\{{
+          padding: 'var(--space-5)',
+          borderRadius: 'var(--radius-md, 0.5rem)',
+          background: 'var(--surface-sub)',
+          marginBottom: 'var(--space-6)',
+          textAlign: 'center',
+        }}>
+          <p style=\{{ color: 'var(--fg-muted)', fontSize: '0.875rem', marginBottom: 'var(--space-2)' }}>
+            Audience submits feedback at:
+          </p>
+          <code style=\{{
+            fontSize: '1.25rem',
+            fontFamily: 'var(--font-mono, monospace)',
+            color: 'var(--primary)',
+            wordBreak: 'break-all',
+          }}>
+            {audienceUrl}
+          </code>
+        </header>
+
+        <h1 style=\{{ fontFamily: 'var(--font-wordmark)', fontSize: '1.75rem', marginBottom: 'var(--space-4)' }}>
+          Live feedback ({feedback.length})
+        </h1>
+
+        <ul style=\{{ listStyle: 'none', padding: 0, margin: 0, display: 'flex', flexDirection: 'column', gap: 'var(--space-3)' }}>
+          {feedback.map((f) => (
+            <li key={f.id} style=\{{
+              padding: 'var(--space-5)',
+              borderRadius: 'var(--radius-md, 0.5rem)',
+              border: `2px solid ${f.scale >= 8 ? 'var(--success)' : f.scale >= 5 ? 'var(--info)' : 'var(--warn)'}`,
+              background: 'var(--surface)',
+            }}>
+              <div style=\{{ display: 'flex', justifyContent: 'space-between', alignItems: 'flex-start', gap: 'var(--space-3)', marginBottom: 'var(--space-2)' }}>
+                <div style=\{{ flex: 1 }}>
+                  <div style=\{{ fontSize: '0.75rem', color: 'var(--fg-muted)', marginBottom: 'var(--space-1)' }}>What landed</div>
+                  <div style=\{{ fontWeight: 600 }}>{f.oneThing}</div>
+                </div>
+                <div style=\{{
+                  padding: 'var(--space-1) var(--space-3)',
+                  borderRadius: 'var(--radius-full, 9999px)',
+                  background: f.scale >= 8 ? 'var(--success)' : f.scale >= 5 ? 'var(--info)' : 'var(--warn)',
+                  color: 'var(--bg)',
+                  fontSize: '0.75rem',
+                  fontWeight: 700,
+                }}>
+                  {f.scale}/10
+                </div>
+              </div>
+              {f.stuck && (
+                <div style=\{{ marginTop: 'var(--space-3)', paddingTop: 'var(--space-3)', borderTop: '1px solid var(--border)' }}>
+                  <div style=\{{ fontSize: '0.75rem', color: 'var(--fg-muted)', marginBottom: 'var(--space-1)' }}>Wants more on</div>
+                  <div style=\{{ fontSize: '0.9375rem', color: 'var(--fg)' }}>{f.stuck}</div>
+                </div>
+              )}
+            </li>
+          ))}
+        </ul>
+      </div>
+    </div>
+  );
+}

package/templates/classroom/next.config.ts.hbs

@@ -0,0 +1,7 @@
+import type { NextConfig } from 'next';
+
+const nextConfig: NextConfig = {
+  output: 'standalone',
+};
+
+export default nextConfig;

package/templates/classroom/postcss.config.mjs.hbs

@@ -0,0 +1,14 @@
+/*
+ * Plain template — Tailwind v4 PostCSS plugin is required even though
+ * the plain scaffold doesn't use Tailwind utility classes. The auth
+ * page CSS shipped by `@githat/nextjs/styles` is processed through
+ * @tailwindcss/postcss at build time. Drop this config and the
+ * auth pages render unstyled.
+ */
+const config = {
+  plugins: {
+    '@tailwindcss/postcss': {},
+  },
+};
+
+export default config;

package/templates/classroom/proxy.ts.hbs

@@ -0,0 +1,10 @@
+import { authProxy } from '@githat/nextjs/proxy';
+
+export const proxy = authProxy({
+  publicRoutes: ['/', '/sign-in', '/sign-up'{{#if includeForgotPassword}}, '/forgot-password', '/reset-password'{{/if}}{{#if includeEmailVerification}}, '/verify-email'{{/if}}],
+  signInUrl: '/sign-in',
+});
+
+export const config = {
+  matcher: ['/((?!_next|api|.*\\..*).*)'],
+};

package/templates/classroom/tsconfig.json.hbs

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": { "@/*": ["./*"] }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/templates/content/app/newsletter/page.tsx.hbs

@@ -0,0 +1,90 @@
+'use client';
+
+import { useState } from 'react';
+
+/**
+ * Free newsletter sign-up.
+ *
+ * Newsletters work without a GitHat account — readers just give an
+ * email. Real apps POST to /api/newsletter/subscribe which calls
+ * GitHat's POST /email/send to confirm + your audience-of-record
+ * (Postgres `subscribers` table, MailerLite, etc.).
+ *
+ * Keep this page simple — adding fields kills conversion.
+ */
+export default function NewsletterPage() {
+  const [email, setEmail] = useState('');
+  const [submitted, setSubmitted] = useState(false);
+
+  return (
+    <div style=\{{
+      background: 'var(--bg)',
+      color: 'var(--fg)',
+      minHeight: 'calc(100vh - 64px)',
+      display: 'flex',
+      alignItems: 'center',
+      justifyContent: 'center',
+      padding: 'var(--space-4)',
+    }}>
+      <div style=\{{ maxWidth: '32rem', width: '100%', textAlign: 'center' }}>
+        {submitted ? (
+          <>
+            <h1 style=\{{ fontFamily: 'var(--font-wordmark)', fontSize: '2rem', marginBottom: 'var(--space-3)' }}>
+              Check your inbox
+            </h1>
+            <p style=\{{ color: 'var(--fg-muted)' }}>
+              We sent a confirmation to <strong>{email}</strong>. Click the link
+              and you'll get the next post when it ships.
+            </p>
+          </>
+        ) : (
+          <>
+            <h1 style=\{{ fontFamily: 'var(--font-wordmark)', fontSize: '2rem', marginBottom: 'var(--space-3)' }}>
+              Get the newsletter
+            </h1>
+            <p style=\{{ color: 'var(--fg-muted)', marginBottom: 'var(--space-6)' }}>
+              Free posts, occasional extras. Unsubscribe any time.
+            </p>
+            <form
+              onSubmit={(e) => {
+                e.preventDefault();
+                /* TODO: POST /api/newsletter/subscribe { email } */
+                setSubmitted(true);
+              }}
+              style=\{{ display: 'flex', gap: 'var(--space-2)', flexWrap: 'wrap', justifyContent: 'center' }}
+            >
+              <input
+                type="email"
+                required
+                value={email}
+                onChange={(e) => setEmail(e.target.value)}
+                placeholder="you@example.com"
+                style=\{{
+                  flex: '1 1 240px',
+                  padding: 'var(--space-3) var(--space-4)',
+                  borderRadius: 'var(--radius-md, 0.5rem)',
+                  border: '1px solid var(--border)',
+                  background: 'var(--surface)',
+                  color: 'var(--fg)',
+                  fontSize: '1rem',
+                }}
+              />
+              <button type="submit" style=\{{
+                padding: 'var(--space-3) var(--space-6)',
+                borderRadius: 'var(--radius-md, 0.5rem)',
+                border: 'none',
+                background: 'var(--primary)',
+                color: 'var(--bg)',
+                fontWeight: 600,
+                fontSize: '1rem',
+                cursor: 'pointer',
+              }}>
+                Subscribe
+              </button>
+            </form>
+          </>
+        )}
+      </div>
+    </div>
+  );
+}