Recommendations¶
These are opinionated defaults for a small-to-medium web project. Choose the boring option that solves the current problem, and change it when the project has a clear reason to do more.
Domain registrar¶
Use Cloudflare Registrar when your domain extension is supported and you are happy to use Cloudflare DNS. It charges the registry and ICANN price without a registrar markup, and includes WHOIS redaction and one-click DNSSEC.
Use Porkbun when you need a wider choice of extensions or prefer a registrar that shows registration, renewal, and transfer prices together.
Before buying, check the renewal price—not only the first-year promotion—and turn on two-factor authentication, auto-renewal, and registrar lock.
Documentation website¶
Keep documentation in the application repository as Markdown and build a static site. This keeps docs reviewable with code and avoids a database or CMS until non-developers genuinely need one.
| Situation | Recommendation |
|---|---|
| This starter or a Markdown-first project | Zensical |
| React/MDX, versioned docs, or a larger product site | Docusaurus |
| Vue/Vite or a fast content-focused site | VitePress |
For this repository, keep using Zensical. It already matches the Markdown content, navigation, preview, and static build workflow here.
Small-project defaults¶
- Hosting: use the deployment path already documented in Deployment.
- Email: use a transactional provider such as Resend once production email is required.
- Search: use the documentation host's built-in search before adding a separate search service.