virastack 1.0.3 → 1.0.5

package/README.md

@@ -74,10 +74,12 @@ Which ViraStack tools would you like to include?
 | `@virastack/mask` | Input masking and formatting (Phone, IBAN, etc.) |
 | `@virastack/password` | Password visibility toggle with customizable icons and text |
 
-## Options
+## Commands and options
 
-| Flag | Description |
+| Command / flag | Description |
 | :--- | :--- |
+| `init [name]` | Create a new project (default; also runs with no command) |
+| `add <tool>` | Add a tool to an existing project (`mask`, `password`, `ai`) |
 | `--name <name>` | Project name (or pass as positional / `.`) |
 | `--template <name>` | `nextjs` or `tanstack` |
 | `--tools <list>` | Comma-separated tools (`mask,password`) |
@@ -89,9 +91,28 @@ Which ViraStack tools would you like to include?
 | `-v`, `--version` | Print CLI version |
 | `-h`, `--help` | Show usage |
 
+```bash
+pnpm dlx virastack add mask
+pnpm dlx virastack add password
+pnpm dlx virastack add ai
+```
+
+## Included by default
+
+Every template ships with this stack already installed:
+
+| Area | Packages |
+| :--- | :--- |
+| **State** | TanStack Query, Zustand, nuqs |
+| **Form** | React Hook Form, Zod |
+| **Hooks** | `usehooks-ts` |
+| **UI** | Base UI, Framer Motion, Lucide React |
+
+[ViraStack AI](https://github.com/virastack/ai) encodes these choices as agent rules so assistants follow the same stack from day one.
+
 ## Telemetry
 
-To understand which tools and templates are preferred by the community, ViraStack collects strictly anonymous usage data (template, i18n choice, selected tools, package manager, and CLI version). Absolutely no personal data, project names, or file paths are collected.
+To keep usage statistics, ViraStack collects strictly anonymous data (template, i18n choice, selected tools, package manager, and CLI version). Absolutely no personal data, project names, or file paths are collected.
 
 Opt out anytime: `pnpm dlx virastack --telemetry-disable`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "virastack",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Scaffold new projects and add tools from the ViraStack ecosystem with a single command.",
   "author": {
     "name": "Ömer Gülçiçek (ViraStack)",

package/templates/nextjs/README.md

@@ -24,7 +24,7 @@ _The Next.js boilerplate that feels effortless._
 
 ---
 
-**Docs:** [See the docs](https://www.virastack.com/nextjs-boilerplate/)
+**Docs:** [See the docs](https://virastack.com/start/docs)
 
 **Contents:** [Why](#why-virastack) · [Features](#features) · [Getting started](#getting-started) · [Environment](#environment-variables) · [Scripts](#scripts) · [Project structure](#project-structure) · [Customization](#customization) · [ViraStack AI](#virastack-ai) · [Deployment](#deployment)
 

package/templates/nextjs/next.config.ts

@@ -8,7 +8,7 @@ const withBundleAnalyzer = createBundleAnalyzer({
 });
 
 const nextConfig: NextConfig = {
-  reactCompiler: true,
+  reactCompiler: process.env.NODE_ENV === "production",
   turbopack: {
     root: path.join(import.meta.dirname),
   },

package/templates/nextjs/public/llms.txt

@@ -19,7 +19,7 @@ Built on the App Router with Server/Client Components, streaming, and the Metada
 - [Repository (GitHub)](https://github.com/virastack/start): CLI and templates
 - [README](https://github.com/virastack/start/tree/main/templates/nextjs): Features, structure, and conventions
 - [Architecture guide](https://github.com/virastack/ai/blob/main/templates/core/docs/architecture-guide.md): Placement rules and import conventions
-- [Product docs](https://www.virastack.com/nextjs-boilerplate/): ViraStack Next.js boilerplate
+- [Product docs](https://virastack.com/start/docs): ViraStack Start documentation
 
 ## Key Files & Entry Points
 - [`src/app/layout.tsx`](https://github.com/virastack/start/blob/main/templates/nextjs/src/app/layout.tsx): Root layout, fonts, providers

package/templates/tanstack/README.md

@@ -24,7 +24,7 @@ _The TanStack Start boilerplate that feels effortless._
 
 ---
 
-**Docs:** [See the docs](https://www.virastack.com/)
+**Docs:** [See the docs](https://virastack.com/start/docs)
 
 **Contents:** [Why](#why-virastack) · [Features](#features) · [Getting started](#getting-started) · [Environment](#environment-variables) · [Scripts](#scripts) · [Project structure](#project-structure) · [Customization](#customization) · [ViraStack AI](#virastack-ai) · [Deployment](#deployment)
 

package/templates-i18n/nextjs/README.md

@@ -24,7 +24,7 @@ _The Next.js boilerplate that feels effortless._
 
 ---
 
-**Docs:** [See the docs](https://www.virastack.com/nextjs-boilerplate/)
+**Docs:** [See the docs](https://virastack.com/start/docs)
 
 **Contents:** [Why](#why-virastack) · [Features](#features) · [Getting started](#getting-started) · [Environment](#environment-variables) · [Scripts](#scripts) · [Project structure](#project-structure) · [Customization](#customization) · [ViraStack AI](#virastack-ai) · [Deployment](#deployment)
 

package/templates-i18n/nextjs/next.config.ts

@@ -11,7 +11,7 @@ const withBundleAnalyzer = createBundleAnalyzer({
 });
 
 const nextConfig: NextConfig = {
-  reactCompiler: true,
+  reactCompiler: process.env.NODE_ENV === "production",
   turbopack: {
     root: path.join(import.meta.dirname),
   },

package/templates-i18n/nextjs/public/llms.txt

@@ -19,7 +19,7 @@ Built on the App Router with Server/Client Components, streaming, and the Metada
 - [Repository (GitHub)](https://github.com/virastack/start): CLI and templates
 - [README](https://github.com/virastack/start/tree/main/templates/nextjs): Features, structure, and conventions
 - [Architecture guide](https://github.com/virastack/ai/blob/main/templates/core/docs/architecture-guide.md): Placement rules and import conventions
-- [Product docs](https://www.virastack.com/nextjs-boilerplate/): ViraStack Next.js boilerplate
+- [Product docs](https://virastack.com/start/docs): ViraStack Start documentation
 
 ## Key Files & Entry Points
 - [`src/app/layout.tsx`](https://github.com/virastack/start/blob/main/templates/nextjs/src/app/layout.tsx): Root layout, fonts, providers

package/templates-i18n/nextjs/src/app/[locale]/[...rest]/page.tsx

@@ -0,0 +1,5 @@
+import { notFound } from "next/navigation";
+
+export default function CatchAllPage() {
+  notFound();
+}

package/templates-i18n/nextjs/src/app/[locale]/layout.tsx

@@ -2,8 +2,8 @@ import type { Metadata } from "next";
 import { Inter } from "next/font/google";
 import { notFound } from "next/navigation";
 
-import { NextIntlClientProvider } from "next-intl";
-import { getMessages, setRequestLocale } from "next-intl/server";
+import { hasLocale, NextIntlClientProvider } from "next-intl";
+import { setRequestLocale } from "next-intl/server";
 import { NuqsAdapter } from "nuqs/adapters/next/app";
 
 import { defaultMetadata } from "@/config/seo.config";
@@ -37,14 +37,12 @@ export default async function RootLayout({
 }>) {
   const { locale } = await params;
 
-  if (!routing.locales.includes(locale as "en" | "tr")) {
+  if (!hasLocale(routing.locales, locale)) {
     notFound();
   }
 
   setRequestLocale(locale);
 
-  const messages = await getMessages();
-
   return (
     <html
       lang={locale}
@@ -53,7 +51,7 @@ export default async function RootLayout({
       data-scroll-behavior="smooth"
     >
       <body className="flex min-h-full flex-col antialiased" suppressHydrationWarning>
-        <NextIntlClientProvider messages={messages}>
+        <NextIntlClientProvider>
           <NuqsAdapter>
             <Providers>{children}</Providers>
           </NuqsAdapter>

package/templates-i18n/nextjs/src/app/layout.tsx

@@ -0,0 +1,6 @@
+import type { ReactNode } from "react";
+
+// Required by Next.js when `app/not-found.tsx` exists.
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return children;
+}

package/templates-i18n/nextjs/src/app/not-found.tsx

@@ -0,0 +1,13 @@
+"use client";
+
+import Error from "next/error";
+
+export default function GlobalNotFound() {
+  return (
+    <html lang="en">
+      <body>
+        <Error statusCode={404} />
+      </body>
+    </html>
+  );
+}

package/templates-i18n/nextjs/src/i18n/request.ts

@@ -1,13 +1,11 @@
+import { hasLocale } from "next-intl";
 import { getRequestConfig } from "next-intl/server";
 
 import { routing } from "./routing";
 
 export default getRequestConfig(async ({ requestLocale }) => {
-  let locale = await requestLocale;
-
-  if (!locale || !routing.locales.includes(locale as "en" | "tr")) {
-    locale = routing.defaultLocale;
-  }
+  const requested = await requestLocale;
+  const locale = hasLocale(routing.locales, requested) ? requested : routing.defaultLocale;
 
   return {
     locale,

package/templates-i18n/nextjs/src/proxy.ts

@@ -1,16 +1,9 @@
-import type { NextRequest } from "next/server";
-
 import createMiddleware from "next-intl/middleware";
 
 import { routing } from "./i18n/routing";
 
-const handleI18nRouting = createMiddleware(routing);
-
-export default async function proxy(request: NextRequest) {
-  return handleI18nRouting(request);
-}
+export default createMiddleware(routing);
 
 export const config = {
-  // Match all pathnames except for api, trpc, _next, _vercel, and static files
   matcher: "/((?!api|trpc|_next|_vercel|.*\\..*).*)",
 };

package/templates-i18n/tanstack/README.md

@@ -24,7 +24,7 @@ _The TanStack Start boilerplate that feels effortless._
 
 ---
 
-**Docs:** [See the docs](https://www.virastack.com/)
+**Docs:** [See the docs](https://virastack.com/start/docs)
 
 **Contents:** [Why](#why-virastack) · [Features](#features) · [Getting started](#getting-started) · [Environment](#environment-variables) · [Scripts](#scripts) · [Project structure](#project-structure) · [Customization](#customization) · [ViraStack AI](#virastack-ai) · [Deployment](#deployment)
 

package/templates-i18n/tanstack/public/llms.txt

@@ -19,7 +19,7 @@ Built on TanStack Router file-based routing with type-safe loaders, nested layou
 - [Repository (GitHub)](https://github.com/virastack/start): CLI and templates
 - [README](https://github.com/virastack/start/tree/main/templates/tanstack): Features, structure, and conventions
 - [Architecture guide](https://github.com/virastack/ai/blob/main/templates/core/docs/architecture-guide.md): Placement rules and import conventions
-- [Product docs](https://www.virastack.com/): ViraStack
+- [Product docs](https://virastack.com/start/docs): ViraStack Start documentation
 
 ## Key Files & Entry Points
 - [`src/routes/__root.tsx`](https://github.com/virastack/start/blob/main/templates/tanstack/src/routes/__root.tsx): Root route, document shell, providers, SEO head