oss.codes

open source, everything.

oss.codes takes the best products we find — tools we wish existed for free — and rebuilds them completely in the open. Every line of code is public. Fork it, self-host it, contribute to it. We don't believe in closed infrastructure for solved problems.

This repo is the website: a minimal, terminal-flavored community reference and blog, built with Astro.

What's here

• Homepage — the project registry, live stats, manifesto, and a contribute section.
• Blog (/blog) — notes on building in the open, Markdown/MDX content collections, RSS.
• About (/about) — principles and how the rebuild process works.

Project structure

src/
├── components/        # Nav, Footer, ProjectCard, FormattedDate
├── content/blog/      # Markdown/MDX blog posts (the content collection)
├── data/projects.ts   # the project registry — add a rebuild here, it shows on the homepage
├── layouts/           # Base (shared shell) + BlogPost
├── pages/             # index, about, blog/, rss.xml.js
├── styles/global.css  # the terminal design system + design tokens
└── consts.ts          # site metadata, nav links, social handles

Add a project

Edit src/data/projects.ts and append an entry — name, description, repo, status. It renders into the homepage grid automatically.

Write a blog post

Drop a .md or .mdx file into src/content/blog/ with title, description, and pubDate frontmatter. It appears in /blog, the homepage "from the blog" list, and the RSS feed.

Commands

Run from the project root:

Command	Action
bun install	Install dependencies
bun dev	Start the dev server at localhost:4321
bun build	Build the production site to ./dist/
bun preview	Preview the production build locally

Working with Claude Code? Use the background dev server: astro dev --background (manage with astro dev status / astro dev logs / astro dev stop).

License

MIT — everything. Fork away.