create-vitnode-app 2.0.0-canary.7 → 2.0.0-canary.9

package/README.md

@@ -75,6 +75,7 @@ plugins: [myPlugin()]
 | `--package-manager` | Choose `npm` or `pnpm` for the generated project. |
 | `--eslint` | Include ESLint and Prettier configuration. |
 | `--skip-install` | Skip dependency installation after scaffolding. |
+| `--skip-git` | Skip initializing a git repository (created on `main` after install). |
 | `--mode` | Choose `singleApp`, `apiMonorepo`, or `onlyApi`. |
 | `--monorepo` | Create a workspace layout for plugins and multiple applications. |
 | `--docker` | Include local Docker services. |

package/copy-of-vitnode-app/api-single-app/src/routes/api/$.ts

@@ -1,11 +1,10 @@
-import { createFileRoute } from '@tanstack/react-router'
+import { createFileRoute } from "@tanstack/react-router";
 
-import { apiBridge } from '#/server/vitnode-api.server'
+import { apiBridge } from "@/server/vitnode-api.server";
 
-
-export const Route = createFileRoute('/api/$')({
+export const Route = createFileRoute("/api/$")({
   server: {
     handlers: ({ createHandlers }) =>
       createHandlers({ ANY: async ({ request }) => apiBridge(request) }),
   },
-})
+});

package/copy-of-vitnode-app/api-single-app/src/server/vitnode-api.server.ts

@@ -1,29 +1,29 @@
-import '@tanstack/react-start/server-only'
-import { OpenAPIHono } from '@hono/zod-openapi'
-import { VitNodeAPI } from '@vitnode/core/api/config'
+import "@tanstack/react-start/server-only";
+import { OpenAPIHono } from "@hono/zod-openapi";
+import { VitNodeAPI } from "@vitnode/core/api/config";
 
-import { createApiBridge } from '#/server/api-bridge'
-import { vitNodeApiConfig } from '#/vitnode.api.config'
+import { createApiBridge } from "@/server/api-bridge";
+import { vitNodeApiConfig } from "@/vitnode.api.config";
 
 // The same two lines `apps/api` and `apps/docs` run. `basePath("/api")` is what
 // makes the mount point part of the API's own routing, so every path the plugins
 // register - `/api/@vitnode/core/...` - resolves identically here.
 const createVitNodeApi = () => {
-  const app = new OpenAPIHono().basePath('/api')
+  const app = new OpenAPIHono().basePath("/api");
 
-  VitNodeAPI({ app, vitNodeApiConfig })
+  VitNodeAPI({ app, vitNodeApiConfig });
 
-  return app
-}
+  return app;
+};
 
 // `VitNodeAPI` is a boot step, not a request step: it opens the Redis client,
 // starts the cron scheduler and registers every plugin route. Vite re-evaluates
 // server modules on HMR, so the instance is parked on `globalThis` to keep one
 // API per process instead of one per edit.
 const cache = globalThis as typeof globalThis & {
-  __vitnodeApi?: ReturnType<typeof createVitNodeApi>
-}
+  __vitnodeApi?: ReturnType<typeof createVitNodeApi>;
+};
 
-export const vitNodeApi = (cache.__vitnodeApi ??= createVitNodeApi())
+export const vitNodeApi = (cache.__vitnodeApi ??= createVitNodeApi());
 
-export const apiBridge = createApiBridge(vitNodeApi)
+export const apiBridge = createApiBridge(vitNodeApi);

package/copy-of-vitnode-app/root/src/components/admin-shell.tsx

@@ -1,15 +1,8 @@
-import type { AdminUserSearch } from "@vitnode/core/tanstack/admin";
-
 import { AdminShellContent } from "@vitnode/core/tanstack/admin";
+import { useAppNavigate } from "@vitnode/core/tanstack/auth";
 import { LanguageSwitcher } from "@vitnode/core/tanstack/layout";
 
-import { adminNav } from "#/lib/admin-nav";
-import { adminUserSearchFn } from "#/lib/admin-search";
-import { useAppNavigate } from "#/lib/navigation";
-
-
-const searchUsers: AdminUserSearch = async search =>
-  await adminUserSearchFn({ data: { search } });
+import { adminNav } from "@/admin-nav.gen";
 
 export const AdminShell = ({ children }: { children: React.ReactNode }) => {
   const navigate = useAppNavigate();
@@ -21,7 +14,6 @@ export const AdminShell = ({ children }: { children: React.ReactNode }) => {
       onNavigate={href => {
         void navigate(href);
       }}
-      searchUsers={searchUsers}
     >
       {children}
     </AdminShellContent>

package/copy-of-vitnode-app/root/src/components/main-footer.tsx

@@ -0,0 +1,44 @@
+import {
+  VITNODE_DOCS_URL,
+  VITNODE_SPONSOR_URL,
+  VITNODE_WEBSITE_URL,
+} from "@vitnode/core/lib/docs-links";
+import { Heart } from "lucide-react";
+
+export const MainFooter = () => (
+  <footer className="border-t">
+    <div className="text-muted-foreground container mx-auto flex flex-col items-center justify-between gap-3 px-4 py-6 text-sm sm:flex-row">
+      <p>
+        Powered by{" "}
+        <a
+          className="text-foreground font-medium underline-offset-4 hover:underline"
+          href={VITNODE_WEBSITE_URL}
+          rel="noopener noreferrer"
+          target="_blank"
+        >
+          VitNode
+        </a>
+      </p>
+
+      <nav aria-label="VitNode" className="flex items-center gap-5">
+        <a
+          className="hover:text-foreground transition-colors"
+          href={VITNODE_DOCS_URL}
+          rel="noopener noreferrer"
+          target="_blank"
+        >
+          Docs
+        </a>
+        <a
+          className="hover:text-foreground flex items-center gap-1.5 transition-colors"
+          href={VITNODE_SPONSOR_URL}
+          rel="noopener noreferrer"
+          target="_blank"
+        >
+          <Heart className="size-3.5" />
+          Sponsor
+        </a>
+      </nav>
+    </div>
+  </footer>
+);

package/copy-of-vitnode-app/root/src/lib/i18n.ts

@@ -0,0 +1,37 @@
+/**
+ * The one bootstrap adapter this application still owns.
+ *
+ * Auth, the AdminCP session and the AdminCP user search all reach the API
+ * through `@vitnode/core`'s own default transports now, so none of them needs a
+ * module here. Messages cannot work that way, for two reasons that only hold
+ * in app source:
+ *
+ * - `loadIntlMessages` reads *this* application's locale barrels, which are the
+ *   app's own files plus whichever packages it installed. A package cannot know
+ *   them.
+ * - `createServerFn` is extracted by the TanStack Start compiler, and the
+ *   compiler only runs over the application's source. `@vitnode/core` ships
+ *   precompiled, so a server function declared there would never have its
+ *   handler extracted and would resolve to `undefined` at runtime.
+ *
+ * `configureIntl` is where the two meet: the app hands core the fetch and its
+ * configured languages, and everything else in the package reads them back
+ * through `getIntlRuntime()`.
+ */
+import { createServerFn } from "@tanstack/react-start";
+import { configureIntl, validateIntlInput } from "@vitnode/core/tanstack/i18n";
+import { IntlProvider } from "use-intl";
+
+import { loadIntlMessages } from "@/server/messages.server";
+import { vitNodeConfig } from "@/vitnode.config";
+
+export const getIntlMessages = createServerFn()
+  .validator(validateIntlInput)
+  .handler(async ({ data }) => await loadIntlMessages(data));
+
+export const { localeRouting } = configureIntl({
+  fetchMessages: async input => await getIntlMessages({ data: input }),
+
+  hostIntlProvider: IntlProvider,
+  i18n: vitNodeConfig.i18n,
+});

package/copy-of-vitnode-app/root/src/router.tsx

@@ -3,6 +3,8 @@ import type { AnyRouter } from "@tanstack/react-router";
 import { createRouter as createTanStackRouter } from "@tanstack/react-router";
 import { setupRouterSsrQueryIntegration } from "@tanstack/react-router-ssr-query";
 import { createVitNodeQueryClient } from "@vitnode/core/lib/query-client";
+import { createLocaleRewrite } from "@vitnode/core/tanstack/i18n";
+import { pageHead } from "@vitnode/core/tanstack/metadata";
 import { RoutePendingSpinner } from "@vitnode/core/tanstack/pending";
 import {
   pluginRouteSpecs,
@@ -14,18 +16,14 @@ import {
   withCoreRootRoutes,
 } from "@vitnode/core/tanstack/routes";
 
-import "./lib/auth";
-
-import "./lib/admin-auth";
-import { createLocaleRewrite, localeRouting } from "./lib/i18n/runtime";
-import { pageHead } from "./lib/page-head";
+import { localeRouting } from "./lib/i18n";
 import { pluginRouteSources } from "./plugin-routes.gen";
 import { Route as adminShellRoute } from "./routes/_admin";
 import { Route as mainShellRoute } from "./routes/_main";
 import { routeTree as fileRouteTree } from "./routeTree.gen";
 
 const loadContentRegistry = async () =>
-  (await import("./lib/content-registry")).contentRegistry;
+  (await import("./content-registry.gen")).contentRegistry;
 
 const routeTree = withCoreRootRoutes(
   withCoreAdminRoutes(

package/copy-of-vitnode-app/root/src/routes/__root.tsx

@@ -18,9 +18,9 @@ import {
 } from "@vitnode/core/tanstack/i18n";
 import { VitNodeRootProviders } from "@vitnode/core/tanstack/layout";
 
-import type { Locale } from "#/lib/i18n/shared";
+import type { Locale } from "@/vitnode.config";
 
-import { vitNodeConfig } from "#/vitnode.config";
+import { vitNodeConfig } from "@/vitnode.config";
 
 import appCss from "../styles.css?url";
 
@@ -53,9 +53,10 @@ export const Route = createRootRouteWithContext<RootRouterContext>()({
     ],
   }),
   loader: async ({ context }) => {
-    await context.queryClient.ensureQueryData(
-      intlQueryOptions({ locale: context.locale }),
-    );
+    await context.queryClient.query({
+      ...intlQueryOptions({ locale: context.locale }),
+      staleTime: "static",
+    });
   },
   shellComponent: RootDocument,
 });

package/copy-of-vitnode-app/root/src/routes/_admin.tsx

@@ -7,9 +7,9 @@ import {
   loadAdminMessages,
   preloadAdminAccess,
 } from "@vitnode/core/tanstack/admin";
+import { pageHead } from "@vitnode/core/tanstack/metadata";
 
-import { AdminShell } from "#/components/admin-shell";
-import { pageHead } from "#/lib/page-head";
+import { AdminShell } from "@/components/admin-shell";
 
 export const Route = createFileRoute("/_admin")({
   beforeLoad: async ({ context, location, preload }) => {
@@ -47,7 +47,7 @@ export const Route = createFileRoute("/_admin")({
   },
 
   loader: async ({ context }) => {
-    const { adminNav } = await import("#/lib/admin-nav");
+    const { adminNav } = await import("@/admin-nav.gen");
 
     await loadAdminMessages({ ...context, namespaces: adminNav.namespaces });
   },

package/copy-of-vitnode-app/root/src/routes/_main/index.tsx

@@ -1,30 +1,196 @@
-import { createFileRoute } from "@tanstack/react-router";
+import type { LucideIcon } from "lucide-react";
 
-import { pageHead } from "#/lib/page-head";
+import type { RegisteredRouter } from "@tanstack/react-router";
+
+import { createFileRoute, Link } from "@tanstack/react-router";
+import { LogoVitNode } from "@vitnode/core/components/logo-vitnode";
+import { buttonVariants } from "@vitnode/core/components/ui/button";
+import {
+  VITNODE_DOCS_URL,
+  VITNODE_WEBSITE_URL,
+} from "@vitnode/core/lib/docs-links";
+import { useSessionQuery } from "@vitnode/core/tanstack/auth";
+import { pageHead } from "@vitnode/core/tanstack/metadata";
+import { cn } from "cn";
+import {
+  ArrowUpRight,
+  BookOpen,
+  Globe,
+  ShieldCheck,
+  UserRoundPlus,
+} from "lucide-react";
+
+const REGISTER_HREF = "/register";
+const ADMIN_HREF = "/admin";
 
 export const Route = createFileRoute("/_main/")({
   head: () =>
     pageHead({
-      description: "A VitNode application.",
+      description: "Your VitNode app is up and running.",
       robots: "index, follow",
-      title: "Home",
+      title: "Welcome",
     }),
   component: HomeRoute,
 });
 
+interface NextStep {
+  description: string;
+  external?: boolean;
+  href: string;
+  icon: LucideIcon;
+  title: string;
+}
+
+const registerStep: NextStep = {
+  description:
+    "Create a member account. On a fresh install the first one becomes the administrator.",
+  href: REGISTER_HREF,
+  icon: UserRoundPlus,
+  title: "Register",
+};
+
+const sharedSteps: NextStep[] = [
+  {
+    description: "Settings, members, roles, plugins and content live here.",
+    href: ADMIN_HREF,
+    icon: ShieldCheck,
+    title: "AdminCP",
+  },
+  {
+    description: "Configuration, routing, plugins and deployment guides.",
+    external: true,
+    href: VITNODE_DOCS_URL,
+    icon: BookOpen,
+    title: "Documentation",
+  },
+  {
+    description: "Project website, release notes and community links.",
+    external: true,
+    href: VITNODE_WEBSITE_URL,
+    icon: Globe,
+    title: "vitnode.com",
+  },
+];
+
 function HomeRoute() {
+  const { data } = useSessionQuery();
+  const user = data?.user ?? null;
+  const steps = user ? sharedSteps : [registerStep, ...sharedSteps];
+
   return (
-    <div className="container mx-auto flex max-w-2xl flex-col gap-4 p-4">
-      <h1 className="text-3xl font-semibold tracking-tight text-balance">
-        Welcome to VitNode
-      </h1>
-
-      <p className="text-muted-foreground leading-relaxed text-pretty">
-        Edit <code>src/routes/_main/index.tsx</code> to change this page. The
-        header, the footer and the shell around it are{" "}
-        <code>@vitnode/core</code>&rsquo;s; everything under{" "}
-        <code>src/routes</code> is yours.
+    <div className="container mx-auto flex max-w-3xl flex-col gap-14 px-4 py-16 sm:py-24">
+      <section className="flex flex-col items-center gap-6 text-center">
+        <LogoVitNode className="size-14" idPrefix="welcome-logo" small />
+
+        <div className="flex flex-col gap-3">
+          <h1 className="text-4xl font-semibold tracking-tight text-balance sm:text-5xl">
+            Your VitNode app is running
+          </h1>
+
+          <p className="text-muted-foreground mx-auto max-w-xl text-lg leading-relaxed text-pretty">
+            {user
+              ? `You are signed in as ${user.name}. Open the AdminCP to configure the site.`
+              : "Create an account or sign in, then open the AdminCP to configure the site. On a fresh install the first registered member becomes the administrator."}
+          </p>
+        </div>
+
+        <div className="flex flex-col gap-3 sm:flex-row">
+          {user ? null : (
+            <Link
+              className={cn(buttonVariants({ size: "lg" }), "px-5")}
+              to={REGISTER_HREF}
+            >
+              <UserRoundPlus />
+              Create an account
+            </Link>
+          )}
+
+          <Link
+            className={cn(
+              buttonVariants({
+                size: "lg",
+                variant: user ? "default" : "outline",
+              }),
+              "px-5",
+            )}
+            to={ADMIN_HREF}
+          >
+            <ShieldCheck />
+            Open AdminCP
+          </Link>
+        </div>
+      </section>
+
+      <section className="flex flex-col gap-4">
+        <h2 className="text-muted-foreground text-xs font-medium tracking-wider uppercase">
+          Next steps
+        </h2>
+
+        <div
+          className={cn(
+            "grid gap-3",
+            steps.length === 3 ? "sm:grid-cols-3" : "sm:grid-cols-2",
+          )}
+        >
+          {steps.map(step => (
+            <NextStepCard key={step.href} {...step} />
+          ))}
+        </div>
+      </section>
+
+      <p className="text-muted-foreground text-center text-sm text-pretty">
+        This page lives in <code>src/routes/_main/index.tsx</code>. Replace it
+        whenever you are ready.
       </p>
     </div>
   );
 }
+
+function NextStepCard({
+  description,
+  external = false,
+  href,
+  icon: Icon,
+  title,
+}: NextStep) {
+  const className =
+    "group bg-card hover:bg-muted/50 focus-visible:border-ring focus-visible:ring-ring/50 flex flex-col gap-3 rounded-xl border p-5 transition-colors outline-none focus-visible:ring-3";
+
+  const content = (
+    <>
+      <div className="flex items-center justify-between">
+        <span className="bg-primary/10 text-primary flex size-9 items-center justify-center rounded-lg">
+          <Icon className="size-4.5" />
+        </span>
+
+        <ArrowUpRight className="text-muted-foreground size-4 transition-transform group-hover:translate-x-0.5 group-hover:-translate-y-0.5" />
+      </div>
+
+      <div className="flex flex-col gap-1">
+        <span className="font-medium">{title}</span>
+        <span className="text-muted-foreground text-sm leading-relaxed text-pretty">
+          {description}
+        </span>
+      </div>
+    </>
+  );
+
+  if (external) {
+    return (
+      <a
+        className={className}
+        href={href}
+        rel="noopener noreferrer"
+        target="_blank"
+      >
+        {content}
+      </a>
+    );
+  }
+
+  return (
+    <Link<RegisteredRouter, string, string> className={className} href={href}>
+      {content}
+    </Link>
+  );
+}

package/copy-of-vitnode-app/root/src/routes/_main.tsx

@@ -5,8 +5,8 @@ import {
   ThemeLayoutContent,
 } from "@vitnode/core/tanstack/layout";
 
-import { MainHeader } from "#/components/main-header";
-
+import { MainFooter } from "@/components/main-footer";
+import { MainHeader } from "@/components/main-header";
 
 export const Route = createFileRoute("/_main")({
   loader: async ({ context }) => await loadMainShell(context),
@@ -15,8 +15,15 @@ export const Route = createFileRoute("/_main")({
 
 function MainLayout() {
   return (
-    <ThemeLayoutContent breadcrumb={<MainBreadcrumb />} header={<MainHeader />}>
-      <Outlet />
-    </ThemeLayoutContent>
+    <div className="flex min-h-svh flex-col [&>main]:flex-1">
+      <ThemeLayoutContent
+        breadcrumb={<MainBreadcrumb />}
+        header={<MainHeader />}
+      >
+        <Outlet />
+      </ThemeLayoutContent>
+
+      <MainFooter />
+    </div>
   );
 }

package/copy-of-vitnode-app/root/src/server/messages.server.ts

@@ -1,7 +1,7 @@
 import "@tanstack/react-start/server-only";
 import { createIntlMessagesLoader } from "@vitnode/core/tanstack/i18n/server";
 
-import { vitNodeServerConfig } from "#/vitnode.server.config";
+import { vitNodeServerConfig } from "@/vitnode.server.config";
 
 export type { IntlMessages } from "@vitnode/core/tanstack/i18n/server";
 

package/copy-of-vitnode-app/root/src/start.ts

@@ -1,5 +1,5 @@
 import { createVitNodeStart } from "@vitnode/core/tanstack/start";
 
-import { vitNodeConfig } from "#/vitnode.config";
+import { vitNodeConfig } from "@/vitnode.config";
 
 export const startInstance = createVitNodeStart({ config: vitNodeConfig });

package/copy-of-vitnode-app/root/src/styles.css

@@ -86,6 +86,10 @@
 }
 
 @theme inline {
+  --font-sans:
+    -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue",
+    "Noto Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji",
+    "Segoe UI Symbol", "Noto Color Emoji";
   --font-heading: var(--font-sans);
   --color-sidebar-ring: var(--sidebar-ring);
   --color-sidebar-border: var(--sidebar-border);

package/copy-of-vitnode-app/root/src/vitnode.config.ts

@@ -5,6 +5,7 @@ export const vitNodeConfig = buildConfig({
   i18n: {
     defaultLocale: "en",
     locales: [{ code: "en", name: "English" }],
+    timeZone: "UTC",
   },
   metadata: {
     shortTitle: "VitNode",
@@ -15,3 +16,5 @@ export const vitNodeConfig = buildConfig({
     defaultTheme: "system",
   },
 });
+
+export type Locale = (typeof vitNodeConfig.i18n.locales)[number]["code"];

package/copy-of-vitnode-app/root/src/vitnode.server.config.ts

@@ -1,9 +1,9 @@
 import "@tanstack/react-start/server-only";
 import { buildServerConfig } from "@vitnode/core/vitnode.config";
 
-import { appMessages } from "#/locales/app";
-import { packageMessages } from "#/locales/packages";
-import { vitNodeConfig } from "#/vitnode.config";
+import { appMessages } from "@/locales/app";
+import { packageMessages } from "@/locales/packages";
+import { vitNodeConfig } from "@/vitnode.config";
 
 export const vitNodeServerConfig = buildServerConfig({
   config: vitNodeConfig,

package/copy-of-vitnode-app/root/tsconfig.json

@@ -1,12 +1,17 @@
 {
-  "include": ["**/*.ts", "**/*.tsx", "eslint.config.js", "prettier.config.js", "vite.config.js"],
-  
+  "include": [
+    "**/*.ts",
+    "**/*.tsx",
+    "eslint.config.js",
+    "prettier.config.js",
+    "vite.config.js"
+  ],
+
   "compilerOptions": {
     "target": "ES2022",
     "jsx": "react-jsx",
     "module": "ESNext",
     "paths": {
-      "#/*": ["./src/*"],
       "@/*": ["./src/*"]
     },
     "lib": ["ES2022", "DOM", "DOM.Iterable"],

package/dist/src/create/create-vitnode.js

@@ -4,11 +4,17 @@ import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import ora from "ora";
 import color from "picocolors";
+import { initGitRepository } from "../helpers/init-git.js";
 import { generateMigrationsVitnode } from "../helpers/init-vitnode.js";
 import { installDependencies } from "../helpers/install-dependencies.js";
 import { isFolderEmpty } from "../helpers/is-folder-empty.js";
 import { createPackageJSON } from "./create-package-json.js";
-export const createVitNode = async ({ root, appName, packageManager, eslint, install, docker, mode, monorepo, }) => {
+const GIT_WARNINGS = {
+    "already-in-repository": "Skipped git setup - the project already lives inside a git repository.",
+    failed: 'Could not initialize a git repository. Run "git init" in the project yourself once git is configured.',
+    "git-unavailable": 'Git is not installed, so no repository was created. Run "git init" in the project after installing git.',
+};
+export const createVitNode = async ({ root, appName, packageManager, eslint, git, install, docker, mode, monorepo, }) => {
     const spinner = ora(`Creating a new VitNode app in ${color.green(root)}. Using ${color.green(packageManager)}...`).start();
     const __filename = fileURLToPath(import.meta.url);
     const __dirname = dirname(__filename);
@@ -200,5 +206,13 @@ export const createVitNode = async ({ root, appName, packageManager, eslint, ins
             process.exit(1);
         }
     }
+    let gitResult;
+    if (git) {
+        spinner.text = "Initializing git repository...";
+        gitResult = await initGitRepository({ root });
+    }
     spinner.succeed(`${color.green("Success!")} Created ${color.cyan(appName)} at ${color.cyan(root)}`);
+    if (gitResult && gitResult !== "created") {
+        console.log(color.yellow(GIT_WARNINGS[gitResult]));
+    }
 };

package/dist/src/create/package-versions.js

@@ -33,7 +33,7 @@ export const versionsPackageJson = {
     cva: "^0.7.1",
     tanstackReactRouter: "^1.170",
     tanstackReactStart: "^1.168",
-    tanstackReactQuery: "^5.101",
+    tanstackReactQuery: "^5.102",
     tanstackRouterSsrQuery: "^1.167",
     tanstackReactDevtools: "^0.10",
     tanstackDevtoolsVite: "^0.8",

package/dist/src/helpers/init-git.js

@@ -0,0 +1,38 @@
+import { rm } from "node:fs/promises";
+import { join } from "node:path";
+import { spawnCommand } from "./spawn-command.js";
+export const DEFAULT_GIT_BRANCH = "main";
+const runGit = async (args, cwd) => new Promise(resolve => {
+    const child = spawnCommand("git", args, { cwd, stdio: "ignore" });
+    child.on("error", () => {
+        resolve(false);
+    });
+    child.on("close", code => {
+        resolve(code === 0);
+    });
+});
+export const initGitRepository = async ({ root, branch = DEFAULT_GIT_BRANCH, commitMessage = "Initial commit from Create VitNode App", }) => {
+    if (!(await runGit(["--version"], root))) {
+        return "git-unavailable";
+    }
+    if (await runGit(["rev-parse", "--is-inside-work-tree"], root)) {
+        return "already-in-repository";
+    }
+    const removeGitDirectory = async () => {
+        await rm(join(root, ".git"), { force: true, recursive: true });
+    };
+    const initialized = (await runGit(["init", "--initial-branch", branch], root)) ||
+        ((await runGit(["init"], root)) &&
+            (await runGit(["symbolic-ref", "HEAD", `refs/heads/${branch}`], root)));
+    if (!initialized) {
+        await removeGitDirectory();
+        return "failed";
+    }
+    const committed = (await runGit(["add", "-A"], root)) &&
+        (await runGit(["commit", "-m", commitMessage], root));
+    if (!committed) {
+        await removeGitDirectory();
+        return "failed";
+    }
+    return "created";
+};