aredotna/api-examples

This is a collection of self contained example applications that demonstrate different ways to build on the Are.na API. Are.na is a platform for saving and organizing online content into channels, similar to mood boards or reference libraries, and this repo shows developers practical patterns for working with it. The repo contains three independent examples, each in its own folder with its own stack and its own live Vercel deployment. The explorer example is a generic Are.na client that lets you browse channels, blocks, and user profiles, built with Vite, React 18, and Are.na's published SDK and React Query packages. The portfolio example generates a minimal static portfolio site from a single public Are.na channel, with masonry layout, block permalinks, OG tags, and RSS, using Next.js 15 and React 19. The swimlanes example renders an Are.na channel as a Kanban style board with Tailwind and shadcn/ui. None of the examples share code across folders. The guiding idea is that each should be readable top to bottom on its own, picking the simplest stack for what it demonstrates. The explorer and swimlanes examples require an Are.na OAuth application with write scope, while the portfolio example only needs a public channel URL, no OAuth setup at all. To run an example locally, you install dependencies once from the repo root using pnpm, copy the relevant environment file, and run the dev script for the example you want. Shared tooling includes a pnpm workspace and a Biome config for formatting and linting. Each example deploys as its own separate Vercel project, so they can be studied and adapted independently.