create-sailor 1.10.0 → 2.0.0

package/templates/docs/fumadocs/content/docs/getting-started.mdx

@@ -1,56 +0,0 @@
----
-title: Getting Started
-description: Run your first example in 5 minutes
----
-
-{/* 2026 BEST PRACTICE: Getting Started's ONLY goal is 5-minute first example */}
-{/* 2026 BEST PRACTICE: No architecture explanation here — that belongs in Concepts */}
-{/* 2026 BEST PRACTICE: Structure: Install → Initialize → Hello World → Next steps */}
-
-# Getting Started
-
-## Install
-
-```bash
-npm install @your-product/sdk
-```
-
-## Initialize
-
-```ts title="src/index.ts"
-import { YourProduct } from '@your-product/sdk';
-
-const client = new YourProduct({
-  apiKey: process.env.YOUR_API_KEY,
-});
-```
-
-## Hello World
-
-<Tabs items={['TypeScript', 'Python', 'cURL']}>
-<Tab value="TypeScript">
-```ts
-const result = await client.hello();
-console.log(result);
-```
-</Tab>
-<Tab value="Python">
-```python
-result = client.hello()
-print(result)
-```
-</Tab>
-<Tab value="cURL">
-```bash
-curl https://api.your-product.com/hello \
-  -H "Authorization: Bearer $YOUR_API_KEY"
-```
-</Tab>
-</Tabs>
-
-## Next steps
-
-<Cards>
-  <Card title="Concepts" href="/docs/concepts" />
-  <Card title="API Reference" href="/docs/api" />
-</Cards>

package/templates/docs/fumadocs/content/docs/index.mdx

@@ -1,17 +0,0 @@
----
-title: Welcome to {PRODUCT_NAME}
-description: Your product's docs home page
----
-
-{/* 2026 BEST PRACTICE: Hero with 2-3 line description, no marketing fluff */}
-{/* 2026 BEST PRACTICE: 3-6 quick-start cards is highest-value module on docs home */}
-
-# Welcome to {PRODUCT_NAME}
-
-Build AI-native SaaS products faster.
-
-<Cards>
-  <Card title="Getting Started" href="/docs/getting-started" description="Run your first example in 5 minutes" />
-  <Card title="Concepts" href="/docs/concepts" description="Core mental models" />
-  <Card title="API Reference" href="/docs/api" description="Complete API documentation" />
-</Cards>

package/templates/docs/fumadocs/content/docs/meta.json

@@ -1,4 +0,0 @@
-{
-  "title": "Documentation",
-  "pages": ["index", "getting-started", "concepts", "api"]
-}

package/templates/docs/fumadocs/lib/source.ts

@@ -1,7 +0,0 @@
-import { loader } from "fumadocs-core/source";
-import { docs } from "@/.source/server";
-
-export const source = loader({
-  baseUrl: "/docs",
-  source: docs.toFumadocsSource(),
-});

package/templates/docs/fumadocs/next.config.mjs

@@ -1,20 +0,0 @@
-import { createMDX } from "fumadocs-mdx/next";
-
-const withMDX = createMDX({
-  configPath: "source.config.ts",
-  outDir: ".source",
-});
-
-/** @type {import('next').NextConfig} */
-const nextConfig = {
-  reactStrictMode: true,
-  transpilePackages: [
-    "@nebutra/ui",
-    "@nebutra/tokens",
-    "fumadocs-ui",
-    "fumadocs-core",
-    "fumadocs-mdx",
-  ],
-};
-
-export default withMDX(nextConfig);

package/templates/docs/fumadocs/package.json

@@ -1,33 +0,0 @@
-{
-  "name": "@nebutra/docs",
-  "private": true,
-  "version": "0.0.1",
-  "scripts": {
-    "predev": "fumadocs-mdx",
-    "dev": "next dev -p 3001",
-    "prebuild": "fumadocs-mdx",
-    "build": "_FUMADOCS_MDX=1 next build",
-    "start": "next start -p 3001",
-    "typecheck": "fumadocs-mdx && _FUMADOCS_MDX=1 next typegen && tsc --noEmit"
-  },
-  "dependencies": {
-    "@nebutra/tokens": "^0.1.0",
-    "@nebutra/ui": "^0.1.0",
-    "fumadocs-core": "^16.6.12",
-    "fumadocs-mdx": "^14.2.9",
-    "fumadocs-ui": "^16.6.12",
-    "next": "^16.2.6",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4"
-  },
-  "devDependencies": {
-    "@tailwindcss/postcss": "^4.2.1",
-    "@types/mdx": "^2.0.13",
-    "@types/node": "^22.19.15",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
-    "tailwindcss": "^4.2.1",
-    "typescript": "^5.9.3"
-  },
-  "license": "MIT"
-}

package/templates/docs/fumadocs/source.config.ts

@@ -1,17 +0,0 @@
-import { defineConfig, defineDocs, frontmatterSchema } from "fumadocs-mdx/config";
-
-export const docs = defineDocs({
-  dir: "content/docs",
-  docs: {
-    schema: frontmatterSchema,
-  },
-});
-
-export default defineConfig({
-  mdxOptions: {
-    // Add remark / rehype plugins here as needed.
-    // See: https://fumadocs.vercel.app/docs/mdx
-    remarkPlugins: [],
-    rehypePlugins: [],
-  },
-});

package/templates/docs/fumadocs/tsconfig.json

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

package/templates/docs/mintlify/README.md

@@ -1,25 +0,0 @@
-# {PRODUCT_NAME} Docs
-
-Documentation site for {PRODUCT_NAME}, built with [Mintlify](https://mintlify.com/).
-
-## Develop
-
-```bash
-pnpm install
-pnpm dev          # http://localhost:3001
-```
-
-## Add a page
-
-1. Create an `.mdx` file at the root or under a subdirectory
-2. Add it to `navigation` in `mint.json`
-
-## Deploy
-
-Mintlify deploys from your `main` branch. Connect the repo at [dashboard.mintlify.com](https://dashboard.mintlify.com) — no build step needed.
-
-## Check broken links
-
-```bash
-pnpm broken-links
-```

package/templates/docs/mintlify/api-reference/introduction.mdx

@@ -1,25 +0,0 @@
----
-title: "API Reference"
-description: "{PRODUCT_NAME} REST API"
----
-
-## Authentication
-
-All endpoints require a bearer token in the `Authorization` header.
-
-```bash
-curl https://api.example.com/v1/health \
-  -H "Authorization: Bearer YOUR_TOKEN"
-```
-
-## Generating from OpenAPI
-
-Mintlify can auto-generate this section from an OpenAPI spec. Add to `mint.json`:
-
-```json
-{
-  "openapi": "https://api.example.com/openapi.json"
-}
-```
-
-Then run `mint openapi-to-mdx` to scaffold endpoint pages.

package/templates/docs/mintlify/introduction.mdx

@@ -1,21 +0,0 @@
----
-title: "Introduction"
-description: "Welcome to {PRODUCT_NAME}"
----
-
-## Overview
-
-This is the documentation site for **{PRODUCT_NAME}**, scaffolded by [create-sailor](https://github.com/Nebutra/Nebutra-Sailor) with the [Mintlify](https://mintlify.com/) framework.
-
-Mintlify is a hosted documentation platform that renders MDX with rich components and built-in search. There is no static build — Mintlify handles deployment from your `main` branch.
-
-## What's included
-
-<CardGroup cols={2}>
-  <Card title="Quickstart" icon="rocket" href="/quickstart">
-    Boot the docs site locally
-  </Card>
-  <Card title="API reference" icon="terminal" href="/api-reference/introduction">
-    OpenAPI-driven endpoints
-  </Card>
-</CardGroup>

package/templates/docs/mintlify/mint.json

@@ -1,37 +0,0 @@
-{
-  "$schema": "https://mintlify.com/schema.json",
-  "name": "{PRODUCT_NAME}",
-  "logo": {
-    "light": "/logo/light.svg",
-    "dark": "/logo/dark.svg"
-  },
-  "favicon": "/favicon.svg",
-  "colors": {
-    "primary": "#0033FE",
-    "light": "#0BF1C3",
-    "dark": "#0033FE"
-  },
-  "topbarLinks": [
-    {
-      "name": "Support",
-      "url": "mailto:hi@example.com"
-    }
-  ],
-  "topbarCtaButton": {
-    "name": "Dashboard",
-    "url": "https://example.com/app"
-  },
-  "navigation": [
-    {
-      "group": "Get started",
-      "pages": ["introduction", "quickstart"]
-    },
-    {
-      "group": "API reference",
-      "pages": ["api-reference/introduction"]
-    }
-  ],
-  "footerSocials": {
-    "github": "https://github.com/your-org/your-repo"
-  }
-}

package/templates/docs/mintlify/package.json

@@ -1,14 +0,0 @@
-{
-  "name": "@nebutra/docs",
-  "private": true,
-  "version": "0.0.1",
-  "scripts": {
-    "dev": "mint dev --port 3001",
-    "build": "mint build",
-    "broken-links": "mint broken-links"
-  },
-  "devDependencies": {
-    "mint": "^4.2.0"
-  },
-  "license": "MIT"
-}

package/templates/docs/mintlify/quickstart.mdx

@@ -1,26 +0,0 @@
----
-title: "Quickstart"
-description: "Run the {PRODUCT_NAME} docs locally"
----
-
-## Install the Mintlify CLI
-
-```bash
-pnpm install
-```
-
-## Run the dev server
-
-```bash
-pnpm dev
-```
-
-The docs site runs on http://localhost:3001 with hot reload.
-
-## Edit a page
-
-All pages are MDX files at the project root or under subdirectories like `api-reference/`. The navigation is configured in `mint.json` — add new entries under the `navigation` array.
-
-## Deploy
-
-Mintlify deploys from your `main` branch automatically. Connect your repo at [dashboard.mintlify.com](https://dashboard.mintlify.com).

package/templates/docs/nextra/README.md

@@ -1,35 +0,0 @@
-# {PRODUCT_NAME} Docs
-
-Documentation site for {PRODUCT_NAME}, built with [Nextra v4](https://nextra.site/) (App Router) + Next.js 16.
-
-## Develop
-
-```bash
-pnpm install
-pnpm dev          # http://localhost:3001
-```
-
-## Add a page
-
-Create a `.mdx` file under `content/`:
-
-```mdx
----
-title: My new page
----
-
-# My new page
-
-content here
-```
-
-That's it — file-based routing handles the rest.
-
-## Deploy
-
-Any Next.js host: Vercel, Cloudflare Pages, Railway, self-hosted Node.
-
-```bash
-pnpm build
-pnpm start
-```

package/templates/docs/nextra/app/[[...mdxPath]]/page.tsx

@@ -1,23 +0,0 @@
-import { generateStaticParamsFor, importPage } from "nextra/pages";
-import { useMDXComponents as getMDXComponents } from "../../mdx-components";
-
-export const generateStaticParams = generateStaticParamsFor("mdxPath");
-
-export async function generateMetadata(props: { params: Promise<{ mdxPath?: string[] }> }) {
-  const params = await props.params;
-  const { metadata } = await importPage(params.mdxPath);
-  return metadata;
-}
-
-const Wrapper = getMDXComponents().wrapper;
-
-export default async function Page(props: { params: Promise<{ mdxPath?: string[] }> }) {
-  const params = await props.params;
-  const result = await importPage(params.mdxPath);
-  const { default: MDXContent, toc, metadata } = result;
-  return (
-    <Wrapper toc={toc} metadata={metadata}>
-      <MDXContent {...props} params={params} />
-    </Wrapper>
-  );
-}

package/templates/docs/nextra/app/layout.tsx

@@ -1,36 +0,0 @@
-import { Banner, Head } from "nextra/components";
-import { getPageMap } from "nextra/page-map";
-import { Footer, Layout, Navbar } from "nextra-theme-docs";
-import "nextra-theme-docs/style.css";
-
-export const metadata = {
-  title: { default: "{PRODUCT_NAME} Docs", template: "%s — {PRODUCT_NAME}" },
-  description: "Documentation for {PRODUCT_NAME}.",
-};
-
-const banner = <Banner storageKey="docs-launch">{"{PRODUCT_NAME}"} docs are live</Banner>;
-const navbar = <Navbar logo={<b>{"{PRODUCT_NAME}"}</b>} />;
-const footer = (
-  <Footer>
-    © {new Date().getFullYear()} {"{PRODUCT_NAME}"}
-  </Footer>
-);
-
-export default async function RootLayout({ children }: { children: React.ReactNode }) {
-  return (
-    <html lang="en" dir="ltr" suppressHydrationWarning>
-      <Head />
-      <body>
-        <Layout
-          banner={banner}
-          navbar={navbar}
-          pageMap={await getPageMap()}
-          docsRepositoryBase="https://github.com/your-org/your-repo/tree/main"
-          footer={footer}
-        >
-          {children}
-        </Layout>
-      </body>
-    </html>
-  );
-}

package/templates/docs/nextra/content/_meta.ts

@@ -1,4 +0,0 @@
-export default {
-  index: { title: "Welcome", display: "hidden" },
-  "getting-started": "Getting Started",
-};

package/templates/docs/nextra/content/getting-started.mdx

@@ -1,35 +0,0 @@
----
-title: Getting Started
----
-
-# Getting Started with {PRODUCT_NAME}
-
-## Install
-
-```bash
-pnpm install
-```
-
-## Develop
-
-```bash
-pnpm dev
-```
-
-The docs site runs on http://localhost:3001.
-
-## Build for production
-
-```bash
-pnpm build
-pnpm start
-```
-
-## Project structure
-
-```
-content/         MDX content — every .mdx is a page
-app/             Next.js App Router (layout + catchall page)
-mdx-components.tsx
-next.config.mjs  Nextra plugin wrapper
-```

package/templates/docs/nextra/content/index.mdx

@@ -1,18 +0,0 @@
----
-title: Welcome to {PRODUCT_NAME}
----
-
-# Welcome to {PRODUCT_NAME}
-
-This is the documentation site for **{PRODUCT_NAME}**, scaffolded by [create-sailor](https://github.com/Nebutra/Nebutra-Sailor) with the [Nextra](https://nextra.site/) framework.
-
-## Why Nextra
-
-Nextra runs on top of Next.js App Router with first-class MDX support, file-based routing, and built-in search. Drop a `.mdx` file under `content/` and it's a page.
-
-## Next steps
-
-- Edit `content/index.mdx` to change this page
-- Add new pages by creating `.mdx` files under `content/`
-- Customize the navbar / footer in `app/layout.tsx`
-- Run `pnpm dev` and visit http://localhost:3001

package/templates/docs/nextra/mdx-components.tsx

@@ -1,10 +0,0 @@
-import { useMDXComponents as getThemeComponents } from "nextra-theme-docs";
-
-const themeComponents = getThemeComponents();
-
-export function useMDXComponents(components?: Record<string, unknown>) {
-  return {
-    ...themeComponents,
-    ...components,
-  };
-}

package/templates/docs/nextra/next.config.mjs

@@ -1,9 +0,0 @@
-import nextra from "nextra";
-
-const withNextra = nextra({
-  search: { codeblocks: false },
-});
-
-export default withNextra({
-  reactStrictMode: true,
-});

package/templates/docs/nextra/package.json

@@ -1,25 +0,0 @@
-{
-  "name": "@nebutra/docs",
-  "private": true,
-  "version": "0.0.1",
-  "scripts": {
-    "dev": "next dev -p 3001",
-    "build": "next build",
-    "start": "next start -p 3001",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "next": "^16.2.6",
-    "nextra": "^4.6.0",
-    "nextra-theme-docs": "^4.6.0",
-    "react": "^19.2.4",
-    "react-dom": "^19.2.4"
-  },
-  "devDependencies": {
-    "@types/node": "^22.19.15",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
-    "typescript": "^5.9.3"
-  },
-  "license": "MIT"
-}

package/templates/docs/nextra/tsconfig.json

@@ -1,21 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "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", "**/*.mdx", ".next/types/**/*.ts"],
-  "exclude": ["node_modules"]
-}

package/templates/docs/vitepress/.vitepress/config.ts

@@ -1,35 +0,0 @@
-import { defineConfig } from "vitepress";
-
-export default defineConfig({
-  title: "{PRODUCT_NAME}",
-  description: "Documentation for {PRODUCT_NAME}",
-  cleanUrls: true,
-
-  themeConfig: {
-    nav: [
-      { text: "Home", link: "/" },
-      { text: "Guide", link: "/guide/introduction" },
-    ],
-
-    sidebar: {
-      "/guide/": [
-        {
-          text: "Guide",
-          items: [
-            { text: "Introduction", link: "/guide/introduction" },
-            { text: "Getting started", link: "/guide/getting-started" },
-          ],
-        },
-      ],
-    },
-
-    socialLinks: [{ icon: "github", link: "https://github.com/your-org/your-repo" }],
-
-    footer: {
-      message: "Released under the MIT License.",
-      copyright: "Copyright © " + new Date().getFullYear() + " {PRODUCT_NAME}",
-    },
-
-    search: { provider: "local" },
-  },
-});

package/templates/docs/vitepress/README.md

@@ -1,23 +0,0 @@
-# {PRODUCT_NAME} Docs
-
-Documentation site for {PRODUCT_NAME}, built with [VitePress](https://vitepress.dev/).
-
-## Develop
-
-```bash
-pnpm install
-pnpm dev          # http://localhost:3001
-```
-
-## Add a page
-
-Drop a `.md` file in any directory, then register it in the `sidebar` of `.vitepress/config.ts`.
-
-## Deploy
-
-```bash
-pnpm build        # static output -> .vitepress/dist
-pnpm preview      # local preview
-```
-
-Host the `.vitepress/dist` directory on any static host (Vercel, Cloudflare Pages, GitHub Pages, S3, etc.).

package/templates/docs/vitepress/guide/getting-started.md

@@ -1,26 +0,0 @@
-# Getting started
-
-## Install
-
-```bash
-pnpm install
-```
-
-## Develop
-
-```bash
-pnpm dev          # http://localhost:3001
-```
-
-## Add a page
-
-Drop a `.md` file under any directory and add it to the `sidebar` in `.vitepress/config.ts`. File-based routing handles the URL.
-
-## Build for production
-
-```bash
-pnpm build        # static output -> .vitepress/dist
-pnpm preview      # serve the built output locally
-```
-
-The `.vitepress/dist` directory is the static output — host on Vercel, Cloudflare Pages, GitHub Pages, S3, or any other static host.

package/templates/docs/vitepress/guide/introduction.md

@@ -1,12 +0,0 @@
-# Introduction
-
-This is the documentation site for **{PRODUCT_NAME}**, scaffolded by [create-sailor](https://github.com/Nebutra/Nebutra-Sailor) with [VitePress](https://vitepress.dev/).
-
-VitePress is a static-site generator built on top of Vite. Markdown files become static HTML pages — no client-side framework required to read the docs, but Vue components are available if you want them.
-
-## Why VitePress
-
-- Vite-powered dev with instant hot reload
-- Markdown-first, with seamless Vue component embedding
-- Built-in local search (no external service needed)
-- Tiny static output, hostable on any CDN