Brewwery Docs

Documentation site for Brewwery — macOS GUI for Homebrew.

Hosted at docs.brewwery.com.

Stack

• Next.js 16
• Nextra 4 (docs theme)
• Static export for deployment

Development

npm install
npm run dev

Open http://localhost:3000.

Build

npm run build

Static output is written to the out/ directory, ready for deployment to any static hosting (Vercel, Cloudflare Pages, Netlify, etc.).

Structure

docs/
├── app/                    # Next.js App Router layout
│   ├── layout.tsx          # Root layout (html, head, body)
│   └── [[...mdxPath]]/    # Catch-all route
│       ├── layout.tsx      # Nextra docs layout (navbar, sidebar, footer)
│       └── page.tsx        # MDX page renderer
├── content/                # MDX documentation pages
│   ├── _meta.ts            # Sidebar navigation order
│   ├── index.mdx           # Introduction
│   ├── getting-started.mdx
│   ├── features.mdx
│   ├── architecture.mdx
│   ├── security.mdx
│   ├── development.mdx
│   ├── roadmap.mdx
│   ├── changelog.mdx
│   ├── faq.mdx
│   └── contributing.mdx
├── public/                 # Static assets
│   └── og-image.png        # Open Graph image for social sharing
├── mdx-components.tsx      # MDX component configuration
├── next.config.mjs         # Next.js + Nextra config
├── tsconfig.json
└── package.json

Deployment

The site exports as fully static HTML. Deploy the out/ directory to any static hosting provider with a custom domain pointing to docs.brewwery.com.

Repository

github.com/brewwery/docs

License

MIT