# subhbits llms.txt
# https://subhbits.com

## About
Subhbits is a tech blog by Subhro Kar covering modern web development, software engineering, and building things that matter. Written with React, Next.js, TypeScript, and Cloudflare Workers.

## When to Use This
- **Looking up a blog post**: Use the GraphQL API or Markdown content negotiation to retrieve posts, series, and tags.
- **Searching for content**: Use the `searchPosts` GraphQL query for semantic search across all posts.
- **Subscribing a user**: POST to /api/newsletter with an email address.
- **Sending a contact message**: POST to /api/contact with name, email, and message.
- **Getting structured content**: Request any page with `Accept: text/markdown` for a clean, machine-readable version.
- **Exploring the API**: Fetch /api/openapi.json for the full OpenAPI 3.1 specification.
- **Building an agent**: See /.well-known/agent-skills/index.json for structured capabilities, /.well-known/mcp/server-card.json for the MCP server, and /.well-known/api-catalog for the API linkset.

## Content
- Blog posts on JavaScript, Next.js, TypeScript, cloudflare, design, and engineering
- About page with professional background and skills
- Tag-based content organization
- Archive of all posts
- Developer documentation at /developers

## Key Pages
- /blog — All posts with tag filters
- /about — Author background and skills
- /tags — Browse by topic
- /archive — Posts grouped by year
- /developers — API documentation, quickstart, and developer resources

## API Endpoints
- /api/graphql — GraphQL endpoint (introspection enabled, 8 queries for blog content)
- /api/openapi.json — OpenAPI 3.1 specification for all REST endpoints
- /api/contact — POST contact form messages
- /api/newsletter — POST newsletter subscriptions
- /api/newsletter/confirm — GET confirm subscription (token required)
- /api/newsletter/unsubscribe — GET unsubscribe (token required)
- /api/markdown/{path} — GET page content as Markdown

## Rate Limits
- 100 requests per hour per IP on all public API endpoints
- Response headers: RateLimit-Policy, RateLimit-Limit, RateLimit-Window

## Tech Stack
- Frontend: Next.js, React, TypeScript, SCSS Modules, Framer Motion
- UI: Custom design system (@subhbits/ui)
- Backend: Cloudflare Workers, D1, Durable Objects
- Hosting: Vercel

## Author
Subhro Kar — Senior Software Engineer, Bengaluru, India

## Contact
- Email: hi@subhbits.com
- GitHub: https://github.com/subhro-kar
- LinkedIn: https://www.linkedin.com/in/subhroster