create-swift-rust 0.4.0 → 0.7.0

package/templates/default/src/components/sidebar.tsx

@@ -0,0 +1,109 @@
+import { Link } from "swift-rust";
+import { Logo } from "./logo";
+
+const ITEMS = [
+  {
+    section: "Workspace",
+    links: [
+      { href: "/dashboard", label: "Overview", icon: IconHome },
+      { href: "/dashboard/analytics", label: "Analytics", icon: IconChart },
+      { href: "/dashboard/posts", label: "Posts", icon: IconDoc },
+    ],
+  },
+  {
+    section: "Settings",
+    links: [
+      { href: "/dashboard/posts/new", label: "New post", icon: IconPlus },
+      { href: "/dashboard/settings", label: "Settings", icon: IconCog },
+    ],
+  },
+];
+
+export function Sidebar({ pathname = "" }: { pathname?: string }) {
+  return (
+    <aside className="sticky top-14 hidden h-[calc(100vh-3.5rem)] w-60 shrink-0 self-start flex-col border-r border-[var(--color-border)] bg-[var(--color-surface)] lg:flex">
+      <div className="flex h-14 items-center border-b border-[var(--color-border)] px-5">
+        <Logo />
+      </div>
+      <nav className="flex-1 space-y-8 overflow-y-auto p-5">
+        {ITEMS.map((group) => (
+          <div key={group.section}>
+            <h3 className="mb-2 px-2 text-[0.7rem] font-semibold uppercase tracking-wider text-[var(--color-fg-subtle)]">
+              {group.section}
+            </h3>
+            <ul className="space-y-0.5">
+              {group.links.map((link) => {
+                const active =
+                  link.href === "/dashboard"
+                    ? pathname === "/dashboard"
+                    : pathname.startsWith(link.href);
+                const Icon = link.icon;
+                return (
+                  <li key={link.href}>
+                    <Link
+                      href={link.href}
+                      className={`flex items-center gap-2.5 rounded-md px-2.5 py-1.5 text-[0.875rem] transition-colors ${
+                        active
+                          ? "bg-[var(--color-accent-soft)] font-medium text-[var(--color-accent)]"
+                          : "text-[var(--color-fg-muted)] hover:bg-[var(--color-surface-2)] hover:text-[var(--color-fg)]"
+                      }`}
+                    >
+                      <Icon className="h-4 w-4" />
+                      {link.label}
+                    </Link>
+                  </li>
+                );
+              })}
+            </ul>
+          </div>
+        ))}
+      </nav>
+      <div className="border-t border-[var(--color-border)] p-4">
+        <div className="rounded-lg border border-[var(--color-border)] bg-[var(--color-surface-2)] p-3">
+          <p className="text-[0.75rem] font-medium text-[var(--color-fg)]">Pro tip</p>
+          <p className="mt-1 text-[0.75rem] leading-relaxed text-[var(--color-fg-muted)]">
+            Press <kbd className="rounded border border-[var(--color-border)] bg-[var(--color-surface)] px-1 font-mono text-[0.6875rem]">⌘K</kbd> for quick search.
+          </p>
+        </div>
+      </div>
+    </aside>
+  );
+}
+
+function IconHome({ className = "" }: { className?: string }) {
+  return (
+    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.75" className={className}>
+      <path d="M3 11l9-7 9 7v9a2 2 0 0 1-2 2h-4v-7H9v7H5a2 2 0 0 1-2-2z" strokeLinejoin="round" />
+    </svg>
+  );
+}
+function IconChart({ className = "" }: { className?: string }) {
+  return (
+    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.75" className={className}>
+      <path d="M3 21h18M6 17v-4m6 4V7m6 10v-7" strokeLinecap="round" />
+    </svg>
+  );
+}
+function IconDoc({ className = "" }: { className?: string }) {
+  return (
+    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.75" className={className}>
+      <path d="M6 3h9l4 4v14a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1Z" strokeLinejoin="round" />
+      <path d="M14 3v5h5M8 13h8M8 17h6" strokeLinecap="round" />
+    </svg>
+  );
+}
+function IconPlus({ className = "" }: { className?: string }) {
+  return (
+    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.75" className={className}>
+      <path d="M12 5v14M5 12h14" strokeLinecap="round" />
+    </svg>
+  );
+}
+function IconCog({ className = "" }: { className?: string }) {
+  return (
+    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.75" className={className}>
+      <circle cx="12" cy="12" r="3" />
+      <path d="M19.4 15a1.7 1.7 0 0 0 .3 1.8l.1.1a2 2 0 1 1-2.8 2.8l-.1-.1a1.7 1.7 0 0 0-1.8-.3 1.7 1.7 0 0 0-1 1.5V21a2 2 0 1 1-4 0v-.1a1.7 1.7 0 0 0-1-1.5 1.7 1.7 0 0 0-1.8.3l-.1.1a2 2 0 1 1-2.8-2.8l.1-.1a1.7 1.7 0 0 0 .3-1.8 1.7 1.7 0 0 0-1.5-1H3a2 2 0 1 1 0-4h.1a1.7 1.7 0 0 0 1.5-1 1.7 1.7 0 0 0-.3-1.8l-.1-.1a2 2 0 1 1 2.8-2.8l.1.1a1.7 1.7 0 0 0 1.8.3h0a1.7 1.7 0 0 0 1-1.5V3a2 2 0 1 1 4 0v.1a1.7 1.7 0 0 0 1 1.5 1.7 1.7 0 0 0 1.8-.3l.1-.1a2 2 0 1 1 2.8 2.8l-.1.1a1.7 1.7 0 0 0-.3 1.8v0a1.7 1.7 0 0 0 1.5 1H21a2 2 0 1 1 0 4h-.1a1.7 1.7 0 0 0-1.5 1Z" />
+    </svg>
+  );
+}

package/templates/default/src/lib/blur.ts

@@ -0,0 +1,5 @@
+/** Soft-orange blur placeholder for photo <Image>s. */
+export const BLUR = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAADElEQVR4nGP4PckGAARVAcq6orJtAAAAAElFTkSuQmCC";
+
+/** Fully transparent placeholder — for logos/icons with transparent edges. */
+export const BLUR_TRANSPARENT = "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAAC0lEQVR4nGNgAAIAAAUAAXpeqz8AAAAASUVORK5CYII=";

package/templates/default/src/lib/format.ts

@@ -0,0 +1,31 @@
+export function formatDate(input: string | number | Date): string {
+  const d = new Date(input);
+  return d.toLocaleDateString("en-US", {
+    year: "numeric",
+    month: "long",
+    day: "numeric",
+  });
+}
+
+export function formatNumber(n: number): string {
+  if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(1)}M`;
+  if (n >= 1_000) return `${(n / 1_000).toFixed(1)}k`;
+  return n.toString();
+}
+
+export function formatPercent(n: number, digits = 1): string {
+  return `${n.toFixed(digits)}%`;
+}
+
+export function relativeTime(input: string | number | Date): string {
+  const ms = Date.now() - new Date(input).getTime();
+  const s = Math.floor(ms / 1000);
+  if (s < 60) return "just now";
+  const m = Math.floor(s / 60);
+  if (m < 60) return `${m}m ago`;
+  const h = Math.floor(m / 60);
+  if (h < 24) return `${h}h ago`;
+  const d = Math.floor(h / 24);
+  if (d < 30) return `${d}d ago`;
+  return formatDate(input);
+}

package/templates/default/src/lib/posts.ts

@@ -0,0 +1,132 @@
+export type Post = {
+  slug: string;
+  title: string;
+  excerpt: string;
+  date: string;
+  readingTime: string;
+  author: { name: string; role: string };
+  tags: string[];
+  body: string;
+  cover?: string;
+};
+
+export const posts: Post[] = [
+  {
+    slug: "introducing-swift-rust",
+    title: "Introducing Swift Rust",
+    cover: "/blog/introducing-swift-rust.svg",
+    excerpt:
+      "A full-stack React framework powered with Rust + Bun, designed to feel as familiar as the one you already use.",
+    date: "2026-05-28",
+    readingTime: "4 min read",
+    author: { name: "The Swift Rust Team", role: "Engineering" },
+    tags: ["announcement", "framework"],
+    body: `Today we are open-sourcing Swift Rust, a full-stack React framework powered with Rust + Bun that takes the parts of Next.js that everyone copied and reimplements them on top of a Rust runtime.
+
+The pitch is simple: write TSX, get streaming SSR, file-system routing, and a single binary at deploy. 10x faster than Next.js. No more pinning the lockfile to dodge a Node deprecation. No more debugging why your edge function works in one region and not another.
+
+We built it because we wanted to use it. The repo is live, the docs are live, and the demo you are reading is rendered by it. If you have ever thought "I wish this was just a Rust binary", we made it one.`,
+  },
+  {
+    slug: "four-rendering-modes",
+    title: "Why we shipped four rendering modes",
+    excerpt:
+      "SSR + WASM, SSR only, SSR + HTMX, and full WASM. One isn't enough. Here is why.",
+    date: "2026-05-20",
+    readingTime: "7 min read",
+    author: { name: "Alex Chen", role: "Founding Engineer" },
+    tags: ["architecture", "ssr", "wasm"],
+    body: `The original Next.js had one mode: SSR. Then it added SSG. Then ISR. Then RSC. Then... you get the idea. We did not want to ship a framework with ten modes and a flowchart.
+
+Instead, we picked four and made each one excellent:
+
+- SSR + WASM is the default. Server-rendered HTML, hydrated with a tiny WASM runtime that gives you client-side islands.
+- SSR only has no client JavaScript at all. Good for documentation sites, blogs, and anywhere you don't need interactivity.
+- SSR + HTMX is for teams that want progressive enhancement without giving up server rendering.
+- Full WASM SPA is for when you genuinely need an app. The whole thing runs in the browser.
+
+Pick the one that fits. Change it later in one line of config.`,
+  },
+  {
+    slug: "streaming-ssr-in-rust",
+    title: "Streaming SSR in Rust, without the headache",
+    excerpt:
+      "How we built a streaming SSR pipeline that handles async components and Suspense correctly.",
+    date: "2026-05-12",
+    readingTime: "9 min read",
+    author: { name: "Priya Singh", role: "Runtime Engineer" },
+    tags: ["ssr", "rust", "internals"],
+    body: `Streaming SSR is one of those features that sounds easy and is, in fact, not. The list of things that can go wrong is long: async components that need to suspend, Suspense boundaries that need to flush, hydration mismatches when the server and client disagree about what to render.
+
+We started from React's renderToReadableStream and built on top of it. The result is a pipeline that:
+
+1. Starts sending HTML within a few milliseconds of the request landing.
+2. Streams async segments as they resolve, with no buffer in between.
+3. Hydrates the page progressively, so the user can interact with above-the-fold content immediately.
+
+The hardest part was getting the error boundary semantics right. We use Rust-style error codes (SR-E0001, SR-E0401, etc.) that are emitted at compile time by our SWC plugin, and a sleek dark error overlay that shows up in the dev server.`,
+  },
+  {
+    slug: "fonts-without-fout",
+    title: "Fonts, without the FOUT",
+    excerpt:
+      "2,071 Google fonts, automatic subsetting, and zero layout shift.",
+    date: "2026-05-04",
+    readingTime: "3 min read",
+    author: { name: "Maria Lopez", role: "Design Systems" },
+    tags: ["fonts", "performance"],
+    body: `Fonts are the most common cause of layout shift on the web. Most frameworks let you load a font, but they do not give you a way to make sure it does not cause a flicker when it loads.
+
+Swift Rust's font component downloads the font at build time, subsets it to the characters you actually use, and emits a CSS variable that you can use in your styles. The browser uses the fallback font for the first paint, and swaps in the real font when it loads, with no layout shift.
+
+We support 2,071 Google fonts out of the box, including Geist, Geist Mono, Inter, Manrope, and IBM Plex. Local fonts work too.`,
+  },
+  {
+    slug: "the-swc-plugin",
+    title: "Inside the SWC plugin",
+    excerpt:
+      "How we turned a 200-millisecond build into a 12-millisecond build.",
+    date: "2026-04-26",
+    readingTime: "11 min read",
+    author: { name: "Jordan Kim", role: "Compiler Engineer" },
+    tags: ["compiler", "swc", "performance"],
+    body: `The single biggest performance win in the framework is the SWC plugin. It runs at build time, and it does three things:
+
+1. Strips "use client" / "use server" directives and replaces them with virtual modules.
+2. Collects imports for the bundler, so it knows exactly what to ship.
+3. Emits error codes (SR-E0001 through SR-E1404) for common mistakes, so the dev server can show you a friendly error message instead of a stack trace.
+
+The plugin is powered with Rust and uses swc_core. It compiles in about a second, and it runs in about 12 milliseconds per file. That is the difference between a 200-millisecond incremental build and a 12-millisecond one.`,
+  },
+  {
+    slug: "single-binary-deploy",
+    title: "Deploy one binary, scale forever",
+    excerpt:
+      "How compiling your app to a Rust binary changes the way you ship.",
+    date: "2026-04-18",
+    readingTime: "5 min read",
+    author: { name: "Sam Rivera", role: "Infrastructure" },
+    tags: ["deployment", "infrastructure"],
+    body: `When you build a Swift Rust app, the output is a single binary. No Node, no edge runtime, no package manager at deploy time. You copy the binary to a server, run it, and it serves.
+
+This has three big consequences:
+
+1. Cold starts are measured in microseconds, not seconds.
+2. Memory usage is measured in tens of megabytes, not hundreds.
+3. There is no "did you forget to install something" at deploy time.
+
+The binary is also a CLI. Run it with no arguments, and it starts a dev server. Run it with --build, and it produces a production binary. Run it with --start, and it serves the production build.`,
+  },
+];
+
+export function getPost(slug: string): Post | undefined {
+  return posts.find((p) => p.slug === slug);
+}
+
+export function getPostsByTag(tag: string): Post[] {
+  return posts.filter((p) => p.tags.includes(tag));
+}
+
+export function getAllTags(): string[] {
+  return Array.from(new Set(posts.flatMap((p) => p.tags))).sort();
+}

package/templates/default/src/lib/site.config.ts

@@ -0,0 +1,39 @@
+/**
+ * Single source of truth for external URLs and the framework version.
+ *
+ * Override URLs at build time with environment variables (e.g. in the Vercel
+ * dashboard or a local .env). The version is read from the installed
+ * `swift-rust` package, so it updates automatically on every release — no
+ * hand-editing "v0.1.0" across the site.
+ */
+import { createRequire } from "node:module";
+import { join } from "node:path";
+
+function swiftRustVersion(): string {
+  try {
+    // Anchor the resolver to the project root (cwd) rather than import.meta.url:
+    // the dev server imports modules with a cache-busting query string, which
+    // makes import.meta.url an invalid base for module resolution.
+    const require = createRequire(join(process.cwd(), "noop.js"));
+    const v = (require("swift-rust/package.json") as { version?: string }).version;
+    if (v) return v;
+  } catch {
+    // ignore
+  }
+  return "0.0.0";
+}
+
+const GITHUB = process.env.SWIFT_RUST_GITHUB_URL ?? "https://github.com/colesites/swift-rust";
+
+export const siteConfig = {
+  /** Marketing / main site. */
+  url: process.env.SWIFT_RUST_SITE_URL ?? "https://swift-rust-self.vercel.app",
+  /** Documentation site. */
+  docsUrl: process.env.SWIFT_RUST_DOCS_URL ?? "https://docs-swift-rust.vercel.app",
+  /** Source repository. */
+  githubUrl: GITHUB,
+  /** GitHub issues. Derived from githubUrl unless explicitly overridden. */
+  issuesUrl: process.env.SWIFT_RUST_ISSUES_URL ?? `${GITHUB}/issues`,
+  /** Framework version, read from the installed swift-rust package. */
+  version: swiftRustVersion(),
+} as const;

package/templates/default/src/lib/stats.ts

@@ -0,0 +1,25 @@
+export type Stat = {
+  label: string;
+  value: string;
+  delta: number;
+  context: string;
+};
+
+export const stats: Stat[] = [
+  { label: "Total requests", value: "2.4M", delta: 12.4, context: "Last 30 days" },
+  { label: "Avg latency", value: "14ms", delta: -8.1, context: "p50, streaming SSR" },
+  { label: "Cache hit rate", value: "97.2%", delta: 0.4, context: "Edge cache" },
+  { label: "Error rate", value: "0.03%", delta: -22.0, context: "5xx responses" },
+];
+
+export const trafficSeries: Array<{ day: string; requests: number }> = [
+  { day: "Mon", requests: 312000 },
+  { day: "Tue", requests: 298000 },
+  { day: "Wed", requests: 354000 },
+  { day: "Thu", requests: 401000 },
+  { day: "Fri", requests: 482000 },
+  { day: "Sat", requests: 367000 },
+  { day: "Sun", requests: 221000 },
+];
+
+export const trafficMax = Math.max(...trafficSeries.map((d) => d.requests));

package/templates/default/swift-rust.config.json

@@ -0,0 +1,8 @@
+{
+  "rendering": "ssr",
+  "reactStrictMode": true,
+  "experimental": {
+    "pdf": true,
+    "wasm": true
+  }
+}

package/templates/default/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "extends": "swift-rust/tsconfig.base.json",
+  "compilerOptions": {
+    "ignoreDeprecations": "6.0",
+    "lib": [
+      "ESNext",
+      "DOM",
+      "DOM.Iterable"
+    ],
+    "jsx": "preserve",
+    "baseUrl": ".",
+    "paths": {
+      "@/*": [
+        "./src/*"
+      ]
+    }
+  },
+  "include": [
+    "src/**/*",
+    "globals.d.ts",
+    ".swift-rust/types/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist",
+    ".swift-rust",
+    ".turbo"
+  ]
+}

package/templates/default/vercel.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://openapi.vercel.sh/vercel.json",
+  "buildCommand": "bun run build",
+  "installCommand": "rm -rf node_modules && bun install",
+  "outputDirectory": ".vercel/output",
+  "framework": null,
+  "trailingSlash": false,
+  "cleanUrls": true,
+  "headers": [
+    {
+      "source": "/_swift-rust/static/(.*)",
+      "headers": [
+        { "key": "Cache-Control", "value": "public, max-age=31536000, immutable" }
+      ]
+    },
+    {
+      "source": "/fonts/(.*)",
+      "headers": [
+        { "key": "Cache-Control", "value": "public, max-age=31536000, immutable" }
+      ]
+    }
+  ]
+}