oriz·home

August 13, 2026 · View on GitHub

The apex landing site for the oriz family — one page that links every *.oriz.in site, tool, book, and package together.

License GitHub stars Last commit Astro

Live site: https://oriz.in · GHP landing: https://chirag127.github.io/oriz-home/ · Repo: https://github.com/chirag127/oriz-home

⭐ If this is useful, please star the repo — it helps others find it.

The apex of the oriz family: the brand landing page, the catalogue of every site, and the shared sign-in entry point. Every other *.oriz.in domain points back here as the canonical hub.

How it composes the family

flowchart TB
  data["src/data/apps.ts<br/>src/lib/family.ts<br/>catalogue of the family"]
  releases["lib/discover-releases.ts<br/>+ lib/media-api.ts<br/>latest blog / book / package"]
  status["StatusBanner<br/>← status.oriz.in"]
  auth["AuthDock / SignInPanel<br/>Clerk + Firebase SSO"]

  subgraph Astro["Astro 6 build (static)"]
    pages["/ · /sites · /about · /contact<br/>/account · /links · /support · /legal"]
    search["⌘K MultiSearch<br/>(cross-site)"]
  end

  cf["Cloudflare Pages → oriz.in"]

  data --> pages
  releases --> pages
  status --> pages
  auth --> pages
  pages --> search
  Astro --> cf
  pages -.->|links out to| fam["~80 *.oriz.in sites"]

Features

  • / landing — brand hub with animated hero (Motion) and live counters.
  • /sites/ family catalogue — every site in the family, driven by src/data/apps.ts.
  • Latest cards — auto-surfaced newest blog post, book, and npm package via discover-releases.ts + RSS.
  • ⌘K MultiSearch — cross-site search from anywhere.
  • StatusBanner — auto-pulls incident state from status.oriz.in.
  • Shared sign-in — /account/ with Google, GitHub, email-link, and anonymous (Clerk + Firebase); the SSO entry point for the whole family.
  • /about, /contact, /links, /support, /legal/* — brand and legal pages.

Tech stack

Astro 6 (static) · React 19 islands · Motion (framer-motion) · lucide-react · @clerk/clerk-react + firebase SSO · rss-parser for release feeds · Fontsource variable fonts · Tailwind CSS v4 · @vite-pwa/astro · Biome · Vitest + Playwright · sharp for icon generation · Wrangler (Cloudflare Pages).

Repo structure

src/
  data/apps.ts             # the family catalogue
  lib/family.ts            # family metadata helpers
  lib/discover-releases.ts # newest blog/book/package
  lib/media-api.ts         # media/feed fetch
  components/              # AppCard, PackageCard, AuthDock, SEO, feature/*
  components/chrome/       # Sidebar, BottomBar, ConsentBanner
  pages/                   # /, sites, about, contact, account, links, legal
  layouts/ · styles/
scripts/gen-icons.mjs      # PWA icon generation
astro.config.mjs · biome.json · playwright.config.ts · vitest.config.ts

Quick start

# On Windows build with npm (pnpm skips @esbuild/win32-x64 → Astro build crash)
npm install --legacy-peer-deps
npm run build              # astro build → dist/
npm run dev                # astro dev
npm test                   # vitest
npm run gen:icons          # regenerate PWA icons

Deploy (Cloudflare Pages): astro build && wrangler pages deploy dist --project-name oriz-home --branch main --commit-dirty=true.

Configuration

Uses the family-wide env set (see .env.example). App-specific keys are limited to the shared account layer.

VariablePurpose
PUBLIC_CLERK_PUBLISHABLE_KEYClerk publishable key for shared *.oriz.in SSO (client-only).
PUBLIC_FIREBASE_*Firebase client config for account features (client-only).
PUBLIC_BASE_PATHOptional base path override for the Astro build.

Security note

No secrets in repo — .env is sops+age-encrypted (.env.enc). Every PUBLIC_* value is client-only; the Clerk secret key and any PUBLIC_*_SECRET are never present. Public content reads without auth; sign-in gates only account features.

Part of the oriz family

The apex of the oriz family by Chirag Singhal — ~80 sites and tools, all $0 on the Cloudflare free tier. Siblings it links to include oriz-lore (knowledge summaries) and omnijournal (open-source PKM).

Contributing

PRs welcome; open an issue first for large changes. Conventional commits are the changelog.

Status

Stable / in production.

License

MIT © Chirag Singhal — chirag@oriz.in · see LICENSE.