docs: add Slack community invite to README and docs (#157)

* docs: add Slack community invite to README and docs Adds a Slack badge and Community section to the README, a new Community & Support page under docs-site/content/docs/community/, and a Community section on the docs introduction page. Routes chat/questions to Slack and bugs/features to GitHub Issues. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * docs: add Slack icon link to docs navbar Adds the Slack brand mark as an icon button in the Fumadocs navbar alongside the existing GitHub link, pointing to the KTX Slack community invite. Persistent across every docs page so users can reach the community from anywhere. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> * docs: order navbar icons as GitHub then Slack Moves the GitHub link out of githubUrl and into the explicit links array so the navbar renders GitHub first, then Slack. Fumadocs appends githubUrl after links, which previously put Slack first. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-06-07 07:55:13 +02:00 · 2026-05-19 18:07:29 -04:00 · 2026-05-19 18:07:29 -04:00 · 8d5186e4ea
commit 8d5186e4ea
parent 620d6adbe6
7 changed files with 132 additions and 2 deletions
--- a/README.md
+++ b/README.md
@ -11,6 +11,7 @@
  <a href="https://codecov.io/gh/Kaelio/ktx"><img src="https://codecov.io/gh/Kaelio/ktx/graph/badge.svg?branch=main" alt="Codecov" /></a>
  <a href="https://github.com/Kaelio/ktx/actions/workflows/ci.yml?query=branch%3Amain"><img src="https://img.shields.io/github/actions/workflow/status/Kaelio/ktx/ci.yml?branch=main&label=tests&style=flat-square" alt="Tests" /></a>
  <a href="https://docs.kaelio.com/ktx/docs/"><img src="https://img.shields.io/badge/docs-KTX-22c55e?style=flat-square" alt="Documentation" /></a>
+  <a href="https://join.slack.com/t/ktxcommunity/shared_invite/zt-3y9b44m1x-LVyNNJD5nwaZHq4XS29LMQ"><img src="https://img.shields.io/badge/slack-join%20community-4A154B?style=flat-square&logo=slack&logoColor=white" alt="Join the KTX Slack community" /></a>
  <a href="https://github.com/Kaelio/ktx/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-blue?style=flat-square" alt="License" /></a>
 </p>

@ -210,8 +211,18 @@ uv run pytest -q
 - [Quickstart](docs-site/content/docs/getting-started/quickstart.mdx)
 - [CLI Reference](docs-site/content/docs/cli-reference/ktx.mdx)
 - [Building Context](docs-site/content/docs/guides/building-context.mdx)
+- [Community & Support](docs-site/content/docs/community/support.mdx)
 - [Contributing](docs-site/content/docs/community/contributing.mdx)

+## Community
+
+- **[Slack](https://join.slack.com/t/ktxcommunity/shared_invite/zt-3y9b44m1x-LVyNNJD5nwaZHq4XS29LMQ)** — ask questions, share what you're building, and chat with maintainers and other users.
+- **[GitHub Issues](https://github.com/Kaelio/ktx/issues)** — report bugs and request features.
+- **[Contributing guide](docs-site/content/docs/community/contributing.mdx)** — set up the repo, run tests, and open a PR.
+
+See [Community & Support](docs-site/content/docs/community/support.mdx) for the
+full guide on where to ask what.
+
 ## License

 KTX is licensed under the Apache License, Version 2.0. See `LICENSE`.
--- a/docs-site/app/layout.config.tsx
+++ b/docs-site/app/layout.config.tsx
@ -1,10 +1,29 @@
 import type { BaseLayoutProps } from "fumadocs-ui/layouts/shared";
+import { GitHubIcon } from "@/components/github-icon";
 import { Logo } from "@/components/logo";
+import { SlackIcon } from "@/components/slack-icon";

 export const baseOptions: BaseLayoutProps = {
  nav: {
    title: <Logo />,
    transparentMode: "top",
  },
-  githubUrl: "https://github.com/kaelio/ktx",
+  links: [
+    {
+      type: "icon",
+      label: "GitHub",
+      icon: <GitHubIcon />,
+      text: "GitHub",
+      url: "https://github.com/kaelio/ktx",
+      external: true,
+    },
+    {
+      type: "icon",
+      label: "Join the KTX Slack community",
+      icon: <SlackIcon />,
+      text: "Slack",
+      url: "https://join.slack.com/t/ktxcommunity/shared_invite/zt-3y9b44m1x-LVyNNJD5nwaZHq4XS29LMQ",
+      external: true,
+    },
+  ],
 };
--- a/docs-site/components/github-icon.tsx
+++ b/docs-site/components/github-icon.tsx
@ -0,0 +1,15 @@
+import type { SVGProps } from "react";
+
+export function GitHubIcon(props: SVGProps<SVGSVGElement>) {
+  return (
+    <svg
+      role="img"
+      viewBox="0 0 24 24"
+      fill="currentColor"
+      aria-hidden="true"
+      {...props}
+    >
+      <path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12" />
+    </svg>
+  );
+}
--- a/docs-site/components/slack-icon.tsx
+++ b/docs-site/components/slack-icon.tsx
@ -0,0 +1,29 @@
+import type { SVGProps } from "react";
+
+export function SlackIcon(props: SVGProps<SVGSVGElement>) {
+  return (
+    <svg
+      viewBox="0 0 122.8 122.8"
+      xmlns="http://www.w3.org/2000/svg"
+      aria-hidden="true"
+      {...props}
+    >
+      <path
+        d="M25.8 77.6c0 7.1-5.8 12.9-12.9 12.9S0 84.7 0 77.6s5.8-12.9 12.9-12.9h12.9v12.9zm6.5 0c0-7.1 5.8-12.9 12.9-12.9s12.9 5.8 12.9 12.9v32.3c0 7.1-5.8 12.9-12.9 12.9s-12.9-5.8-12.9-12.9V77.6z"
+        fill="#E01E5A"
+      />
+      <path
+        d="M45.2 25.8c-7.1 0-12.9-5.8-12.9-12.9S38.1 0 45.2 0s12.9 5.8 12.9 12.9v12.9H45.2zm0 6.5c7.1 0 12.9 5.8 12.9 12.9s-5.8 12.9-12.9 12.9H12.9C5.8 58.1 0 52.3 0 45.2s5.8-12.9 12.9-12.9h32.3z"
+        fill="#36C5F0"
+      />
+      <path
+        d="M97 45.2c0-7.1 5.8-12.9 12.9-12.9s12.9 5.8 12.9 12.9-5.8 12.9-12.9 12.9H97V45.2zm-6.5 0c0 7.1-5.8 12.9-12.9 12.9s-12.9-5.8-12.9-12.9V12.9C64.7 5.8 70.5 0 77.6 0s12.9 5.8 12.9 12.9v32.3z"
+        fill="#2EB67D"
+      />
+      <path
+        d="M77.6 97c7.1 0 12.9 5.8 12.9 12.9s-5.8 12.9-12.9 12.9-12.9-5.8-12.9-12.9V97h12.9zm0-6.5c-7.1 0-12.9-5.8-12.9-12.9s5.8-12.9 12.9-12.9h32.3c7.1 0 12.9 5.8 12.9 12.9s-5.8 12.9-12.9 12.9H77.6z"
+        fill="#ECB22E"
+      />
+    </svg>
+  );
+}
--- a/docs-site/content/docs/community/meta.json
+++ b/docs-site/content/docs/community/meta.json
@ -1,5 +1,5 @@
 {
  "title": "Community",
  "defaultOpen": true,
-  "pages": ["contributing"]
+  "pages": ["support", "contributing"]
 }
--- a/docs-site/content/docs/community/support.mdx
+++ b/docs-site/content/docs/community/support.mdx
@ -0,0 +1,47 @@
+---
+title: Community & Support
+description: Join the KTX Slack community, report bugs, and get help.
+---
+
+KTX is an open-source project. The community is where users, contributors, and
+the core team trade questions, share patterns, and shape the roadmap.
+
+## Where to go
+
+| You want to... | Go here |
+|----------------|---------|
+| Ask a question or chat with the community | [KTX Slack](https://join.slack.com/t/ktxcommunity/shared_invite/zt-3y9b44m1x-LVyNNJD5nwaZHq4XS29LMQ) |
+| Report a bug or request a feature | [GitHub Issues](https://github.com/Kaelio/ktx/issues) |
+| Read or contribute to the docs | [docs.kaelio.com/ktx](https://docs.kaelio.com/ktx/docs/) |
+| Contribute code | [Contributing guide](/docs/community/contributing) |
+
+## Slack
+
+Join the KTX Slack to ask questions, share what you're building, and get help
+from maintainers and other users.
+
+[**Join the KTX Slack →**](https://join.slack.com/t/ktxcommunity/shared_invite/zt-3y9b44m1x-LVyNNJD5nwaZHq4XS29LMQ)
+
+Slack is the right place for:
+
+- **Setup and configuration questions** that don't fit a bug report
+- **Quick "how do I..."** questions
+- **Sharing patterns** for prompts, semantic-layer definitions, or agent workflows
+- **Feedback** on the roadmap and early features
+
+For anything reproducible - a crash, a wrong result, an unexpected CLI error -
+open a [GitHub issue](https://github.com/Kaelio/ktx/issues) instead. Issues are
+searchable, get triaged, and stay attached to the eventual fix.
+
+## GitHub
+
+- **[Issues](https://github.com/Kaelio/ktx/issues)** - bugs and feature requests
+- **[Pull requests](https://github.com/Kaelio/ktx/pulls)** - code, docs, and connector contributions
+- **[Releases](https://github.com/Kaelio/ktx/releases)** - changelog and published versions
+
+## Code of conduct
+
+KTX follows the [Contributor Covenant](https://www.contributor-covenant.org/version/2/1/code_of_conduct/).
+Be respectful, assume good intent, and keep discussion focused on the project.
+Report conduct concerns to the maintainers in Slack or by email at
+`support@kaelio.com`.
--- a/docs-site/content/docs/getting-started/introduction.mdx
+++ b/docs-site/content/docs/getting-started/introduction.mdx
@ -95,3 +95,12 @@ best first step for users; contributor setup lives in the community docs.
    Machine-readable docs and agent-facing setup notes.
  </Card>
 </Cards>
+
+## Community
+
+Have questions, want to share what you're building, or chat with maintainers?
+Join the [KTX Slack community](https://join.slack.com/t/ktxcommunity/shared_invite/zt-3y9b44m1x-LVyNNJD5nwaZHq4XS29LMQ).
+For bug reports and feature requests, open a
+[GitHub issue](https://github.com/Kaelio/ktx/issues). See
+[Community & Support](/docs/community/support) for the full guide on where to
+ask what.