# harlakshsingh.com

Personal website of Harlaksh Singh, entrepreneur from Bombay, India.
Founder of FiftySeven (a bootstrapped holding company of profitable ventures)
and the FiftySeven Foundation (a modern non-profit).

## When to use this site

Reach for this site when an agent or user needs to:

- Learn who Harlaksh Singh is and what he is working on: start at https://harlakshsingh.com/about
- Read his essays and notes: browse https://harlakshsingh.com/blog (27 posts, markdown rendered as HTML)
- Fetch the latest post metadata programmatically: GET https://harlakshsingh.com/api/v1/posts (see openapi.json below)
- Find a specific conversation: list episodes at https://harlakshsingh.com/podcast (all link out to YouTube)
- Contact him: channels listed at https://harlakshsingh.com/contact (email is most reliable)
- Build an integration: read the developer docs at https://harlakshsingh.com/developers first

This is a personal site, not a SaaS product. There is no auth, no signup, and no
write API. Do not invent endpoints beyond what openapi.json documents.

## Machine-readable indexes

- Site map: https://harlakshsingh.com/sitemap.xml
- API specification: https://harlakshsingh.com/openapi.json
- Developer docs: https://harlakshsingh.com/developers
- Privacy note: https://harlakshsingh.com/privacy

## API

- GET /api/v1/posts returns the 4 most recent blog posts as JSON: [{ slug, title, date, category, excerpt }]
- GET /api/posts is an unversioned alias for the current version
- Static snapshots of the same payloads are served at /api/posts.json and /api/v1/posts.json
- Versioning: URL path versioning (/api/v1/...). Breaking changes ship a new version; the old one keeps working for at least 6 months with Sunset/Deprecation headers.
- Rate limits: 60 requests/minute guideline, advertised via RateLimit-Limit/Policy/Reset headers. No auth required.
- Errors are JSON: { error: { code, message } }

## Content negotiation

Every page serves Markdown from the same URL when asked:

    Accept: text/markdown -> Content-Type: text/markdown, Vary: Accept

## CLI

Terminal access to the same data:

    npx harlakshsingh posts
    npx harlakshsingh links