⚡ Project management that doesn't become the project. Boards, Gantt charts, and GitHub integration. Self-host it or use Kaneo Cloud.
TypeScript honoissue-managementissue-trackerjira-alternativekanbanlinear-alternativemcpproject-managementreactself-hostedtypescript
feat(site): group the guides index into topic sections
Andrej83ce56066a2c
diff --git a/apps/site/app/guides/page.tsx b/apps/site/app/guides/page.tsxindex 542d59d71..dcf92eb3e 100644--- a/apps/site/app/guides/page.tsx+++ b/apps/site/app/guides/page.tsx@@ -8,13 +8,14 @@ import { PageIntro } from "@/components/landing/page-intro";import { SectionSeparator } from "@/components/landing/section-separator";import { getPosts } from "@/lib/blog";import { formatBlogDateShort } from "@/lib/blog/format";-import { guideList, guidePath } from "@/lib/guides";+import { guidePath } from "@/lib/guides";+import { guideGroups } from "@/lib/guides/groups";import { withSocialMetadata } from "@/lib/metadata";export const metadata: Metadata = withSocialMetadata({title: "Guides",description:- "Practical guides to open-source and self-hosted project management: choosing a tool, self-hosting with Docker, single sign-on, data residency, and AI agents.",+ "Practical guides to project management: choosing a tool, planning and scheduling a project, agile and kanban basics, and self-hosting your own tracker.",alternates: { canonical: "/guides" },});@@ -34,12 +35,14 @@ export default function Page() {"@context": "https://schema.org","@type": "ItemList",name: "Kaneo guides",- itemListElement: guideList.map((guide, index) => ({- "@type": "ListItem",- position: index + 1,- name: guide.question,- url: `https://kaneo.app${guidePath(guide.slug)}`,- })),+ itemListElement: guideGroups+ .flatMap((group) => group.guides)+ .map((guide, index) => ({+ "@type": "ListItem",+ position: index + 1,+ name: guide.question,+ url: `https://kaneo.app${guidePath(guide.slug)}`,+ })),}}/><Navbar />@@ -52,20 +55,32 @@ export default function Page() {description="The questions people actually ask before choosing a project manager, answered without pretending Kaneo is the answer to all of them."/>- <div className="mt-12 grid gap-6 sm:grid-cols-2 lg:grid-cols-3">- {guideList.map((guide) => (- <ContentCard- body={guide.summary}- href={guidePath(guide.slug)}- key={guide.slug}- meta={[- "Guide",- <time dateTime={guide.updatedOn} key="updated">- Updated {formatBlogDateShort(guide.updatedOn)}- </time>,- ]}- title={guide.question}- />+ <div className="mt-12 space-y-14">+ {guideGroups.map((group) => (+ <section aria-labelledby={group.id} key={group.id}>+ <h2+ className="scroll-mt-24 font-medium text-2xl md:text-3xl"+ id={group.id}+ >+ {group.title}+ </h2>+ <div className="mt-6 grid gap-6 sm:grid-cols-2 lg:grid-cols-3">+ {group.guides.map((guide) => (+ <ContentCard+ body={guide.summary}+ href={guidePath(guide.slug)}+ key={guide.slug}+ meta={[+ "Guide",+ <time dateTime={guide.updatedOn} key="updated">+ Updated {formatBlogDateShort(guide.updatedOn)}+ </time>,+ ]}+ title={guide.question}+ />+ ))}+ </div>+ </section>))}</div></div>diff --git a/apps/site/lib/guides/groups.ts b/apps/site/lib/guides/groups.tsnew file mode 100644index 000000000..c66adcb83--- /dev/null+++ b/apps/site/lib/guides/groups.ts@@ -0,0 +1,90 @@+import { type Guide, guideList, guides } from "./index";++export type GuideGroup = {+ id: string;+ title: string;+ guides: Guide[];+};++const groups: { id: string; title: string; slugs: string[] }[] = [+ {+ id: "choosing-a-tool",+ title: "Choosing a tool",+ slugs: [+ "best-open-source-project-management-software",+ "open-source-jira-alternatives",+ "self-hosted-trello-alternatives",+ "best-free-kanban-board-software",+ "project-management-tools-with-free-sso",+ "project-management-for-small-teams",+ "project-management-for-software-teams",+ "it-project-management",+ "project-management-for-agencies",+ ],+ },+ {+ id: "planning-a-project",+ title: "Planning a project",+ slugs: [+ "what-is-project-planning",+ "project-charter",+ "what-is-project-scope",+ "scope-of-work",+ "work-breakdown-structure",+ "raci-chart",+ "project-kickoff-meeting",+ "project-life-cycle",+ ],+ },+ {+ id: "scheduling",+ title: "Timelines and scheduling",+ slugs: [+ "what-is-a-project-timeline",+ "what-is-a-gantt-chart",+ "critical-path-method",+ "task-dependencies",+ "project-milestones",+ ],+ },+ {+ id: "agile-and-kanban",+ title: "Agile and kanban",+ slugs: [+ "what-is-kanban",+ "kanban-vs-scrum",+ "agile-vs-scrum",+ "backlog-grooming",+ "how-to-prioritize-tasks",+ "moscow-prioritization",+ "definition-of-done-checklist",+ "acceptance-criteria",+ ],+ },+ {+ id: "self-hosting-and-integrations",+ title: "Self-hosting and integrations",+ slugs: [+ "self-host-project-management-docker",+ "cloud-vs-on-premise-project-management",+ "eu-hosted-project-management-gdpr",+ "project-management-mcp-ai-agents",+ "github-issues-kanban-board",+ "gitea-project-management",+ ],+ },+];++const grouped = new Set(groups.flatMap((group) => group.slugs));+const ungrouped = guideList.filter((guide) => !grouped.has(guide.slug));++export const guideGroups: GuideGroup[] = [+ ...groups.map(({ id, title, slugs }) => ({+ id,+ title,+ guides: slugs.flatMap((slug) => (guides[slug] ? [guides[slug]] : [])),+ })),+ ...(ungrouped.length > 0+ ? [{ id: "more-guides", title: "More guides", guides: ungrouped }]+ : []),+];