The Open Framework for Building Agents
Docs: add resources page (#113)
Allen Zhoud33e26bbbd4b
diff --git a/apps/docs/app/[lang]/resources/page.tsx b/apps/docs/app/[lang]/resources/page.tsxnew file mode 100644index 000000000..d12fea730--- /dev/null+++ b/apps/docs/app/[lang]/resources/page.tsx@@ -0,0 +1,73 @@+import type { Metadata } from "next";+import Link from "next/link";+import { translations } from "@/geistdocs";+import { type Resource, resources, type ResourceKind } from "@/lib/resources/data";++const title = "Resources";+const description = "Guides, templates, and examples to help you build with eve.";++const kindClassName: Record<ResourceKind, string> = {+ Community: "border-transparent bg-gray-300 text-gray-1000",+ Example: "border-transparent bg-gray-300 text-gray-1000",+ Guide: "border-transparent bg-gray-300 text-gray-1000",+ Reference: "border-transparent bg-gray-300 text-gray-1000",+ Template: "border-transparent bg-gray-300 text-gray-1000",+};++export const metadata: Metadata = {+ title,+ description,+};++export const generateStaticParams = () => Object.keys(translations).map((lang) => ({ lang }));++const ResourceCard = ({ resource }: { resource: Resource }) => {+ const isExternal = resource.href.startsWith("https://");+ const className =+ "flex h-full flex-col gap-3 rounded-xl border border-gray-alpha-400 bg-background-100 p-6 no-underline shadow-none transition-colors hover:bg-gray-100 dark:bg-gray-100 dark:hover:bg-gray-200";+ const content = (+ <>+ <span+ className={`inline-flex w-fit shrink-0 items-center justify-center rounded-full border px-2 py-0.5 font-medium text-xs ${kindClassName[resource.kind]}`}+ >+ {resource.kind}+ </span>+ <h2 className="line-clamp-2 text-balance font-medium text-base text-gray-1000 leading-snug">+ {resource.title}+ </h2>+ <p className="line-clamp-2 text-gray-900 text-sm">{resource.description}</p>+ </>+ );++ if (isExternal) {+ return (+ <a className={className} href={resource.href} rel="noopener noreferrer" target="_blank">+ {content}+ </a>+ );+ }++ return (+ <Link className={className} href={resource.href}>+ {content}+ </Link>+ );+};++const ResourcesPage = () => (+ <main className="mx-auto w-full max-w-5xl px-4 pt-16 pb-16 sm:pt-24">+ <header className="space-y-4 pb-8">+ <h1 className="text-balance font-semibold text-[40px] text-gray-1000 leading-[1.1] tracking-tight sm:text-5xl">+ {title}+ </h1>+ <p className="max-w-2xl text-gray-900 text-lg leading-relaxed">{description}</p>+ </header>+ <div className="grid gap-4 sm:grid-cols-2 lg:grid-cols-3">+ {resources.map((resource) => (+ <ResourceCard key={resource.title} resource={resource} />+ ))}+ </div>+ </main>+);++export default ResourcesPage;diff --git a/apps/docs/app/sitemap.ts b/apps/docs/app/sitemap.tsindex 6477d871d..57780200e 100644--- a/apps/docs/app/sitemap.ts+++ b/apps/docs/app/sitemap.ts@@ -32,6 +32,11 @@ export default function sitemap(): MetadataRoute.Sitemap {priority: 1,url: url("/"),},+ {+ changeFrequency: "weekly",+ priority: 0.5,+ url: url("/resources"),+ },...pages,];}diff --git a/apps/docs/geistdocs.tsx b/apps/docs/geistdocs.tsxindex bf7f574e0..fc8299ba1 100644--- a/apps/docs/geistdocs.tsx+++ b/apps/docs/geistdocs.tsx@@ -21,6 +21,10 @@ export const nav = [label: "Integrations",href: "/integrations",},+ {+ label: "Resources",+ href: "/resources",+ },{label: "GitHub",href: `https://github.com/${github.owner}/${github.repo}/`,diff --git a/apps/docs/lib/resources/data.ts b/apps/docs/lib/resources/data.tsnew file mode 100644index 000000000..7d24bdc55--- /dev/null+++ b/apps/docs/lib/resources/data.ts@@ -0,0 +1,60 @@+export type ResourceKind = "Community" | "Example" | "Guide" | "Reference" | "Template";++export interface Resource {+ description: string;+ href: string;+ kind: ResourceKind;+ title: string;+}++export const resources: Resource[] = [+ {+ kind: "Guide",+ title: "Build your first agent",+ description:+ "Follow the tutorial from a first agent through warehouse tools, spend approval, and a deployable chat UI.",+ href: "/docs/tutorial/first-agent",+ },+ {+ kind: "Guide",+ title: "Frontend guides",+ description:+ "Use React, Vue, Svelte, Next.js, Nuxt, or SvelteKit helpers to put a durable eve session behind your own UI.",+ href: "/docs/guides/frontend/overview",+ },+ {+ kind: "Guide",+ title: "TypeScript client",+ description:+ "Drive the default HTTP channel from scripts, tests, backend jobs, or custom server-side integrations.",+ href: "/docs/guides/client/overview",+ },+ {+ kind: "Template",+ title: "Eve Chat Template",+ description:+ "A persisted Next.js chat template for Eve, built with shadcn/ui, Tailwind CSS, Streamdown, Better Auth, Drizzle, Neon, and Upstash Redis.",+ href: "https://vercel.com/templates/eve/eve-chat-template",+ },+ {+ kind: "Template",+ title: "Eve Slack Agent",+ description:+ "A Slack agent template with webhook handling, Vercel Connect, a starter agent, and an example tool ready to deploy on Vercel.",+ href: "https://vercel.com/templates/eve/eve-slack-agent",+ },+ {+ kind: "Example",+ title: "Weather Agent Fixture",+ description:+ "A small representative eve app with agent config, instructions, a typed weather tool, and a markdown skill.",+ href: "https://github.com/vercel/eve/tree/main/apps/fixtures/weather-agent",+ },+ {+ kind: "Reference",+ title: "Eve Knowledge Base",+ description:+ "Vercel's Eve hub with getting-started guides, build guides, templates, docs, integrations, and community links.",+ href: "https://vercel.com/kb/eve",+ },+];