Building in Public

Every decision. Every lesson. Every milestone. Completely transparent.

Architecture & Stack

Pure HTML, CSS, and JavaScript. No frameworks. Hosted on Cloudflare's global edge.

System Status

ybb-feedback --
ybb-live-data --
ybb-search --
ybb-mempool-cache --
ybb-live-counter --
ybb-admin Protected

Workers Deep Dive

What each worker does, how data flows, and what privacy guarantees we make. Click any card for the full story.

ybb-feedback

Community engagement — votes, reads, listing clicks. IP hashed (SHA-256), zero PII stored.

▶ Click for details

ybb-live-data

19 live metrics refreshed every 5 minutes — BTC price, hashrate, block height, S&P 500, gold.

▶ Click for details

ybb-search

Hybrid search — Pagefind (client-side WASM) + Vectorize semantic AI (768-dim, 1,267 vectors).

▶ Click for details

ybb-mempool-cache

Caching proxy for mempool.space — block data, fees, mining stats. 60s–300s TTL tiers.

▶ Click for details

ybb-live-counter

Anonymous visitor counter — random sessionId in sessionStorage. No cookies, no fingerprinting.

▶ Click for details

ybb-admin

Internal operations dashboard. Password-protected, HMAC session auth. Not publicly accessible.

▶ Click for details

Content & Community

What we've built so far — and what the community is doing with it.

--
Articles Read
Total articles read by all users since day one. Each time a reader completes a chapter — manually, by voting, or by the 10-minute auto-read timer — the count increases.
--
Community Votes
Total votes cast by readers across all education articles. Both upvotes and downvotes count — every voice matters. Shows how actively the community engages with the content.
--
Services Discovered
Total unique listing visits from The Orange Pages. Each user-listing pair counts once per 24 hours — repeat clicks don't inflate the number. Measures real discovery, not noise.

Content Inventory

21 core education sections across 3 tiers — Beginner (S1–S7), Intermediate (S8–S14), Advanced (S15–S21)
8 supplementary deep dives — Halving, Bitcoin vs Gold, Fiat vs Bitcoin, Bitcoin vs Crypto, Bitcoin Protocol, Bitcoin Dominance, Quantum Computing Threat, The Saylor Playbook
299 Orange Pages listings across 13 categories — exchanges, wallets, mining, payments, and more
79 glossary tooltip terms available on every education page
19 live Bitcoin metrics on the Dashboard — price, hashrate, fees, Lightning, and more
1 Bitcoin Radar — weekly intelligence on adoption, regulation, and macro trends

Live Bitcoin Snapshot

-- Price
-- Block Height
-- Hashrate
-- Difficulty

Build & Deploy Workflow

Every change follows the same pipeline. No shortcuts, no exceptions. Click any step for details.

Edit Code changes in website/
Branch Git branch + commit
Preview Cloudflare Pages preview
PR Pull request on GitHub
Merge Merge to main branch
Production Live at codex-8nj.pages.dev

Tools & Stack

Perplexity (deep research & content auditing) · Claude Code (AI pair programming) · Git / GitHub · Cloudflare Pages · Wrangler CLI · Pure HTML / CSS / JS — no frameworks, no build step

Claude Code powers 95%+ of the workflow — architecture, code, shipping, testing, and every line of HTML/CSS/JS on this site. Perplexity contributes deep research for education articles and supplementary deep dives. The founder directs, reviews, and approves every output. Two AI tools, one human gatekeeper.

“Every change goes through preview before production. Every PR is reviewed. Nothing ships without verification.”

Security & Privacy

What we do to protect you — and what we don't collect.

What We Don't Collect

  • No user accounts, no passwords, no email addresses stored
  • No cookies on the public site (only the admin dashboard uses authenticated cookies)
  • No tracking pixels, no third-party analytics, no Google anything
  • No personal data in any form — we literally can't identify you
  • IP addresses are SHA-256 hashed for rate limiting, then discarded

Security Headers

  • Content Security Policy (CSP) — only our own scripts and styles can run. No inline scripts. No eval.
  • HSTS Preload — forces HTTPS on every connection, with 1-year max-age and subdomain coverage
  • X-Frame-Options: DENY — prevents clickjacking by blocking all iframe embedding
  • Permissions-Policy — 14 unused browser APIs explicitly blocked (camera, mic, geolocation, payment, USB, Bluetooth, serial, MIDI, sensors, screen capture)
  • X-Content-Type-Options: nosniff — prevents MIME-type confusion attacks
  • Referrer-Policy: strict-origin-when-cross-origin — limits referrer data sent to external sites

Code Security

  • Zero external JS/CSS — all fonts, scripts, and stylesheets are self-hosted. No CDN tampering vector.
  • DOM-based rendering — all dynamic content uses document.createElement(), never innerHTML. XSS-safe by design.
  • Worker authentication — admin dashboard uses HMAC cookie auth with Secure; HttpOnly; SameSite=Strict flags
  • Rate limiting — all public API endpoints throttled (60 req/min per IP). Brute-force protection on admin login via KV counters.
  • No secrets in code — API keys stored in environment variables, never committed. Automated pre-commit scanner blocks leaks.

Responsible Disclosure

Found a vulnerability? We want to hear from you.

“The best security is the kind you can verify yourself. Every header, every policy, every line of code — it's all public. We have nothing to hide because we collect nothing to hide.”

Frequently Asked Questions

The questions people actually ask about how we build this.

How is YouBuyBitcoin.com built?

Pure HTML, CSS, and JavaScript — no frameworks, no build step. Hosted on Cloudflare Pages with 6 serverless Workers. Claude Code handles 95%+ of the development workflow. Perplexity contributes deep research for education articles. Every change goes through preview before production.

Does YouBuyBitcoin track users or collect personal data?

No. Zero cookies on the public site, no tracking pixels, no third-party analytics, no Google anything. IP addresses are SHA-256 hashed for rate limiting and then discarded. We literally cannot identify you.

How is YouBuyBitcoin funded?

Through transparent affiliate partnerships with Bitcoin services listed in The Orange Pages. Every affiliate relationship is disclosed. We recommend services based on quality, not commission rates. 21% of net profits are pledged on-chain to Bitcoin education organizations.

Is all the content really free?

Yes. 21 core education sections, 8 supplementary deep dives, 79 glossary terms, 299 catalogued listings, live Bitcoin data — all free, no paywalls, no accounts needed. All educational content is licensed under CC BY-SA 4.0, meaning anyone can use, translate, remix, and share it.

How can I report a security vulnerability?

Email [email protected] or visit our machine-readable security policy at security.txt. We respond within 48 hours.

Ship Log

What changed recently. Built in public — every update logged.

For nerds, but not only — if you care about what's under the hood, you're in the right place.

Newest first — scroll down to see where it all began. Click any entry for details.

    Roadmap

    A decade-long vision, built one sat at a time.

    Phase 1 Foundation 10 milestones
    Core Education 21 free Bitcoin guides from beginner to expert
    Supplementary Articles Deep-dive topics that evolve and grow. 8 and counting.
    The Orange Pages 299 Bitcoin services catalogued across 13 categories
    Swap Aggregator Non-custodial rate comparison across 8 providers
    Bitcoin Radar Live tracking of ETFs, strategic reserves, CBDCs, DeFi
    Dashboard Real-time Bitcoin network metrics
    Search AI-powered semantic search across all content
    Building in Public Full operational transparency with ship log
    Glossary 79 Bitcoin terms explained
    Authors & Contributors Community contribution system
    Phase 2 Growth 6 milestones
    Domain Cutover youbuybitcoin.com serving the live site — 11th April 2026
    ELI5 Toggle Simplified explanations for every section. Just the beginning.
    Translations Multi-language support
    Data Automation Live article data updates across all content
    Adaptive Learning Education that meets you where you are
    Transparency Report First report. $0 revenue, one builder, pure conviction.
    Phase 3 Scale 5 milestones
    Advanced Cloudflare Image optimization, D1 database, Speed Brain
    Mobile App / PWA Native-quality experience on any device
    Community Curators Writers, translators, builders. Knowledge stays free under CC BY-SA 4.0.
    Offline Education Bitcoin education shouldn't need the internet.
    Lightning-Native Tip a sat, zap a sat. The 21% pledge running on Bitcoin itself.
    Phase 4 Maturity 4 milestones
    Community Governance Decentralized decision-making
    API Third-party integrations
    Global Contributor Network Worldwide community of builders
    The Front Door One URL. Everything Bitcoin. If you need it, you find it here.

    Since 2017. Forever.

    This roadmap reflects the founder's personal vision and direction. It is not a promise, guarantee, or legally binding commitment. Priorities may shift. Timelines are intentionally omitted. What you see here is barely 12% of the bigger picture.