ContributingCopy Anchor Link

Thanks for your interest in contributing to @farming-labs/docs. This guide explains how to report issues, propose changes, and submit pull requests.

Code of conductCopy Anchor Link

Please be respectful and constructive. We aim to keep the community welcoming and focused on building a great documentation framework.

How to contributeCopy Anchor Link

Reporting bugsCopy Anchor Link

• GitHub Issues — Open an issue at github.com/farming-labs/docs/issues.
• Include:
  • Clear title and description
  • Steps to reproduce
  • Expected vs actual behavior
  • Your environment (Node version, package manager, framework: Next.js / TanStack Start / SvelteKit / Astro / Nuxt)
  • Relevant config or code snippets

Suggesting featuresCopy Anchor Link

• Open a discussion or issue describing the use case and proposed behavior.
• Check existing issues first to avoid duplicates.

Pull requestsCopy Anchor Link

1. Fork the farming-labs/docs repo and clone it locally.
2. Branch from main (e.g. fix/typo-install-docs or feat/contributing-guide).
3. Install dependencies from the repo root:
   pnpmnpmyarnbun

   Copy Text

   pnpm install

4. Build the monorepo (optional, for core/theme changes):

   Copy Text

   pnpm build

5. Run the docs site (from repo root):

   Copy Text

   pnpm --dir website dev

   Then open http://localhost:3000 to preview.
6. Make your changes — Keep edits focused; doc-only and small fixes are welcome.
7. Commit with a clear message (e.g. docs: add contributing guide, fix: correct CLI flag in installation).
8. Push your branch and open a Pull Request against main.
9. Describe what you changed and why; link any related issues.

Project structureCopy Anchor Link

• packages/ — Core packages: docs, fumadocs (theme), next, svelte, svelte-theme, astro, astro-theme, nuxt, nuxt-theme.
• website/ — This docs site (Next.js); content under app/docs/.
• examples/ — Example apps (Next.js, TanStack Start, and others) for testing. When you work on this monorepo, keep local @farming-labs/* example dependencies linked with workspace:* so CI and Vercel on Node 22 resolve the built workspace adapters instead of an older published package from node_modules.

Doc content lives in website/app/docs/ as MDX. Config and sidebar are driven by docs.config.tsx in website/.

Documentation changesCopy Anchor Link

• Edit or add .mdx files under website/app/docs/.
• Use existing frontmatter (title, description, icon, order) so the sidebar stays consistent.
• Use the shared <Callout>, <Tabs>, and <Tab> components where they fit.

QuestionsCopy Anchor Link

• GitHub Discussions — For general questions and ideas, use github.com/farming-labs/docs/discussions.
• GitHub Issues — You can still use Issues for bugs and actionable feature requests.
• Issues — For bugs and concrete feature requests.

Thank you for contributing.