create-unmint 1.0.0

package/template/content/docs/index.mdx

@@ -0,0 +1,91 @@
+---
+title: Welcome to Unmint
+description: A free, open-source Mintlify-style documentation system
+---
+
+Welcome to **Unmint** — a beautiful, customizable documentation system built with [Next.js](https://nextjs.org), [Fumadocs](https://fumadocs.vercel.app), and more (see [Built With](#built-with) below).
+
+<CardGroup cols={2}>
+  <Card title="Quick Start" icon="rocket" href="/docs/quickstart">
+    Get up and running with Unmint in under 5 minutes.
+  </Card>
+  <Card title="Components" icon="code" href="/docs/components">
+    Explore all the MDX components available out of the box.
+  </Card>
+  <Card title="Theming" icon="gear" href="/docs/theming">
+    Customize colors, fonts, and branding to match your project.
+  </Card>
+  <Card title="Deployment" icon="rocket" href="/docs/deployment">
+    Deploy your docs to Vercel, Netlify, or any static host.
+  </Card>
+</CardGroup>
+
+## What is Unmint?
+
+Unmint is a **free and open-source** alternative to paid documentation platforms like Mintlify. It provides:
+
+- **Beautiful out-of-the-box styling** that looks professional without customization
+- **Full MDX support** with pre-built components (cards, callouts, tabs, steps, etc.)
+- **Built-in search** powered by Fumadocs
+- **Dynamic OG images** generated automatically for social sharing
+- **Dark mode** with seamless theme switching
+- **Easy customization** through a simple theme configuration file
+
+<Tip>
+Unmint is designed to be forked and customized. All the code is yours to modify.
+</Tip>
+
+## Why Unmint?
+
+| Feature | Unmint | Typical SaaS |
+|---------|--------|--------------|
+| Cost | Free | $50-500/mo |
+| Customization | Full control | Limited |
+| Data ownership | 100% yours | Hosted |
+| Self-hosted | Yes | No |
+| Open source | Yes | No |
+
+## Getting Started
+
+```bash
+# Clone the repository
+git clone https://github.com/your-org/unmint.git my-docs
+
+# Install dependencies
+cd my-docs
+npm install
+
+# Start development server
+npm run dev
+```
+
+Then open [http://localhost:3000](http://localhost:3000) to see your docs.
+
+## Built With
+
+Unmint is built on top of excellent open-source projects:
+
+<CardGroup cols={2}>
+  <Card title="Fumadocs" href="https://fumadocs.vercel.app">
+    The documentation framework powering search, MDX processing, and content management.
+  </Card>
+  <Card title="Next.js" href="https://nextjs.org">
+    The React framework for production-grade web applications.
+  </Card>
+  <Card title="Tailwind CSS" href="https://tailwindcss.com">
+    A utility-first CSS framework for rapid UI development.
+  </Card>
+  <Card title="Shiki" href="https://shiki.style">
+    Beautiful syntax highlighting powered by the same engine as VS Code.
+  </Card>
+  <Card title="next-themes" href="https://github.com/pacocoursey/next-themes">
+    Perfect dark mode with zero flash and system preference detection.
+  </Card>
+  <Card title="React" href="https://react.dev">
+    The library for building user interfaces.
+  </Card>
+</CardGroup>
+
+<Note>
+Unmint is fully open source under the MIT license. Feel free to use it for personal or commercial projects.
+</Note>

package/template/content/docs/meta.json

@@ -0,0 +1,13 @@
+{
+  "title": "Documentation",
+  "pages": [
+    "index",
+    "quickstart",
+    "---Getting Started---",
+    "components",
+    "theming",
+    "---Guides---",
+    "deployment",
+    "customization"
+  ]
+}

package/template/content/docs/quickstart.mdx

@@ -0,0 +1,110 @@
+---
+title: Quick Start
+description: Get your documentation site up and running in under 5 minutes
+---
+
+This guide will help you set up Unmint and create your first documentation page.
+
+## Prerequisites
+
+Before you begin, make sure you have:
+
+- **Node.js 18+** installed
+- **npm** or **pnpm** package manager
+- A code editor (VS Code recommended)
+
+## Installation
+
+<Steps>
+  <Step title="Clone the repository">
+    Start by cloning the Unmint template:
+
+    ```bash
+    git clone https://github.com/your-org/unmint.git my-docs
+    cd my-docs
+    ```
+  </Step>
+
+  <Step title="Install dependencies">
+    Install the required npm packages:
+
+    ```bash
+    npm install
+    ```
+  </Step>
+
+  <Step title="Start the development server">
+    Launch the local development server:
+
+    ```bash
+    npm run dev
+    ```
+
+    Open [http://localhost:3000](http://localhost:3000) in your browser.
+  </Step>
+
+  <Step title="Create your first page">
+    Add a new MDX file in `content/docs/`:
+
+    ```mdx
+    ---
+    title: My First Page
+    description: A description of my page
+    ---
+
+    # Hello World
+
+    This is my first documentation page!
+    ```
+  </Step>
+</Steps>
+
+## Project Structure
+
+Here's an overview of the key directories:
+
+```
+my-docs/
+├── app/                    # Next.js app directory
+│   ├── docs/              # Documentation routes
+│   └── components/        # UI components
+├── content/
+│   └── docs/              # Your MDX documentation files
+│       ├── index.mdx      # Homepage
+│       └── meta.json      # Navigation structure
+├── lib/
+│   └── theme-config.ts    # Customize your theme here
+└── public/                # Static assets
+```
+
+## Adding Navigation
+
+Edit `content/docs/meta.json` to configure your sidebar navigation:
+
+```json
+{
+  "title": "Documentation",
+  "pages": [
+    "index",
+    "quickstart",
+    "---Getting Started---",
+    "installation",
+    "configuration"
+  ]
+}
+```
+
+<Info>
+Use `"---Section Name---"` to create section separators in your sidebar.
+</Info>
+
+## Next Steps
+
+<CardGroup cols={2}>
+  <Card title="Learn Components" icon="code" href="/docs/components">
+    Explore all available MDX components
+  </Card>
+  <Card title="Customize Theme" icon="gear" href="/docs/theming">
+    Match your brand colors and styling
+  </Card>
+</CardGroup>

package/template/content/docs/theming.mdx

@@ -0,0 +1,41 @@
+---
+title: Theming
+description: Customize colors, fonts, and branding
+---
+
+All theming options are centralized in `lib/theme-config.ts`.
+
+## Site Configuration
+
+```typescript
+export const siteConfig = {
+  name: 'My Docs',
+  description: 'Documentation for My Project',
+  url: 'https://docs.example.com',
+  logo: { src: '/logo.png', alt: 'My Project', width: 32, height: 32 },
+  links: {
+    github: 'https://github.com/your-org/your-repo',
+  },
+}
+```
+
+## Accent Colors
+
+Customize your accent color:
+
+```typescript
+export const themeConfig = {
+  colors: {
+    light: { accent: '#0891b2' },
+    dark: { accent: '#22d3ee' },
+  },
+}
+```
+
+<Tip>
+Use a brighter shade of your accent color for dark mode.
+</Tip>
+
+## CSS Variables
+
+Available variables: `--accent`, `--accent-foreground`, `--accent-muted`.

package/template/lib/docs-source.ts

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

package/template/lib/theme-config.ts

@@ -0,0 +1,89 @@
+/**
+ * Unmint Theme Configuration
+ *
+ * Customize your documentation's look and feel by modifying this file.
+ * All colors, branding, and styling can be adjusted here.
+ */
+
+export const siteConfig = {
+  // Site metadata
+  name: 'Unmint',
+  description: 'A free, open-source Mintlify-style documentation system',
+  url: 'https://docs.example.com',
+
+  // Logo configuration
+  logo: {
+    src: '/logo.png',
+    alt: 'Unmint',
+    width: 40,
+    height: 40,
+  },
+
+  // Navigation links
+  links: {
+    github: 'https://github.com/your-org/your-repo',
+    discord: 'https://discord.gg/your-invite',
+    twitter: 'https://twitter.com/yourhandle',
+    support: 'mailto:support@example.com',
+  },
+
+  // Footer configuration
+  footer: {
+    copyright: '© 2025 Your Company. All rights reserved.',
+    links: [
+      { label: 'Website', href: 'https://example.com' },
+      { label: 'GitHub', href: 'https://github.com/your-org' },
+    ],
+  },
+}
+
+export const themeConfig = {
+  // Primary accent color - used for active states, links, highlights
+  colors: {
+    // Light mode
+    light: {
+      accent: '#0891b2',        // Primary accent color
+      accentForeground: '#ffffff',
+      accentMuted: 'rgba(8, 145, 178, 0.1)',
+    },
+    // Dark mode
+    dark: {
+      accent: '#22d3ee',        // Brighter for dark backgrounds
+      accentForeground: '#0f172a',
+      accentMuted: 'rgba(34, 211, 238, 0.1)',
+    },
+  },
+
+  // Code block styling
+  codeBlock: {
+    light: {
+      background: '#fafafa',
+      titleBar: '#f3f4f6',
+    },
+    dark: {
+      background: '#1a1a1f',
+      titleBar: '#1f2937',
+    },
+  },
+
+  // OG Image generation settings
+  ogImage: {
+    // Gradient background (CSS gradient string)
+    gradient: 'linear-gradient(135deg, #ffffff 0%, #e0f7fa 50%, #67e8f9 100%)',
+    // Text colors
+    titleColor: '#0f172a',
+    sectionColor: '#0891b2',
+    // Logo URL (absolute URL required for OG images)
+    logoUrl: 'https://example.com/logo.png',
+  },
+}
+
+// Export CSS variable values for use in Tailwind
+export function getCSSVariables(mode: 'light' | 'dark') {
+  const colors = themeConfig.colors[mode]
+  return {
+    '--accent': colors.accent,
+    '--accent-foreground': colors.accentForeground,
+    '--accent-muted': colors.accentMuted,
+  }
+}

package/template/lib/utils.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from 'clsx'
+import { twMerge } from 'tailwind-merge'
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

package/template/next.config.mjs

@@ -0,0 +1,10 @@
+import { createMDX } from 'fumadocs-mdx/next'
+
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  reactStrictMode: true,
+}
+
+const withMDX = createMDX()
+
+export default withMDX(nextConfig)