Skip to content

armgit / kaneo

Public Imported from GitHub
0

⚡ Project management that doesn't become the project. Boards, Gantt charts, and GitHub integration. Self-host it or use Kaneo Cloud.

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.tsx
index 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.ts
new file mode 100644
index 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 }]
+ : []),
+];