Two things, both served from one Next.js app: the landing page at /, and the documentation at /docs, rendered from the Markdown under docs/.
git clone https://github.com/bulwarkmail/website.git
cd website
npm install
npm run devOpen http://localhost:3000 to view the site.
npm run build
npm startsrc/
├── app/ # Next.js App Router pages
│ ├── page.tsx # Landing page
│ ├── docs/ # Documentation pages
│ ├── install/ # Install redirect
│ └── api/ # API routes (docs search)
├── components/ # React components
│ ├── docs/ # Documentation components
│ └── *.tsx # Landing page sections
└── lib/ # Utilities (markdown processing, etc.)
docs/ # Documentation content (Markdown)
├── getting-started/ # Introduction, installation, configuration
│ └── configuration/ # Stalwart setup, authentication, env reference
├── features/ # Email, calendar, contacts, files, PWA
│ └── email/ # Composing, search
├── development/ # Architecture, contributing
├── deployment/ # Docker, manual, reverse proxy
│ └── docker/ # Compose, reverse-proxy
├── guides/ # Customization, keyboard shortcuts, embedded SSO,
│ # plugins, account-security, multi-account, smime,
│ # marketplace, admin
└── branding/ # Brand guidelines
public/ # Static assets
├── branding/ # Logos, favicons
└── screenshots/ # Product screenshots
| Framework | Next.js 16 with App Router |
| Language | TypeScript |
| Styling | Tailwind CSS v4 |
| Markdown | unified / remark / rehype pipeline |
| Icons | Lucide React |
| Animation | Framer Motion |
Documentation is written in Markdown under the docs/ directory. Files use gray-matter frontmatter for metadata:
---
title: Page Title
description: A brief description.
order: 1
---
# Content hereThe documentation system supports:
- GitHub Flavored Markdown
- Syntax-highlighted code blocks with copy button
- Auto-generated sidebar navigation
- Full-text search
- Fork the repository
- Create a feature branch (
git checkout -b feature/my-change) - Commit using Conventional Commits (
git commit -m 'docs: add my change') - Push to the branch (
git push origin feature/my-change) - Open a Pull Request
- Bulwark Webmail - The webmail client
- Stalwart Mail Server - The mail server Bulwark is built for