Building uvin.lk: How I Created Sri Lanka's Bitcoin Education Platform

TL;DR

In 2022, Sri Lanka's economy collapsed. The rupee lost over 70% of its value. Fuel queues stretched for kilometers. People's savings evaporated overnight. I watched all of this happen and decided to build uvin.lk↗ — a free Bitcoin education platform designed specifically for Sri Lankans. Today it has 55 modules, 275 lessons, content in English and Sinhala, 10,000+ learners, a newsletter reaching 1,000+ subscribers across 5 countries, CeyPay integration for accepting 50+ cryptocurrencies, and a published ebook — "The Rise of Bitcoin" — at over 180 pages. The stack is Next.js 15, Supabase, Tailwind v4, and Vercel. This is the full story of why it exists, how I built it, and what I learned.

The Sri Lanka Context — Why This Had to Exist

I need to set the scene properly, because without understanding what happened in Sri Lanka in 2022, the motivation behind uvin.lk makes no sense.

Sri Lanka defaulted on its foreign debt for the first time in its history. The Sri Lankan rupee, which had been trading around 200 to the US dollar at the start of the year, crashed past 360. At one point the black market rate was above 400. That is not a gradual depreciation. That is a currency losing more than 70% of its purchasing power in months.

The downstream effects were brutal. Fuel ran out. People queued for 12 to 16 hours at petrol stations. Cooking gas became impossible to find. Import costs doubled and tripled. Medicine shortages hit hospitals. Inflation spiked above 70%. The Central Bank's foreign reserves dropped below a billion dollars — not enough to cover a few weeks of imports for a country of 22 million people.

I was watching all of this from two perspectives. On the ground in Sri Lanka, I saw my community — friends, family, everyday people — watch their savings lose value in real time. A teacher who had saved 500,000 rupees for her children's education suddenly had the purchasing power of 150,000. A small business owner who priced his goods in rupees but bought inventory in dollars saw his margins disappear overnight.

And then there was the other perspective. I had been studying Bitcoin since before the crisis. Not the speculation side. Not the price charts and moonshot predictions. The actual monetary properties — fixed supply, decentralized issuance, censorship resistance, borderless transfer. The things that sound academic until your own currency collapses and suddenly they are the most practical concepts in the world.

Here is what I realized during those months: Sri Lankans did not lack intelligence or motivation. They lacked access to credible, free, structured education about alternatives to the monetary system that had just failed them. The information that existed was scattered across English-language YouTube channels, Twitter threads, and books that cost more than a day's wages. Nothing was organized into a curriculum. Nothing was in Sinhala. Nothing addressed the specific reality of living in a country with capital controls, limited exchange access, and a collapsing currency.

That gap is why uvin.lk exists.

The First Version — 2022

The first version of uvin.lk was not pretty. It was not supposed to be.

I built it in a few weeks during the worst of the crisis. The goal was simple: get structured Bitcoin education online in a format that Sri Lankans could access for free, right now. Not next quarter. Not after a proper design phase. Now.

The initial version was a straightforward content site. Static pages. Basic navigation. No authentication, no newsletter, no payment integration. Just lessons organized into modules, written in plain language, starting from absolute zero. What is money. What is inflation. What happened to the Sri Lankan rupee and why. What is Bitcoin. How does the blockchain work. How do you actually acquire and store bitcoin safely.

I wrote every word myself. That was non-negotiable from the start. There is too much recycled, surface-level crypto content on the internet — the same five talking points copy-pasted across a thousand blogs. I wanted uvin.lk to be different. Every lesson had to be original, had to assume no prior knowledge, and had to connect the abstract concepts to the specific reality of someone living in Sri Lanka.

The early content was entirely in English. I knew from the beginning that Sinhala content would be essential for reaching the audience that needed it most, but writing technical content in Sinhala is significantly harder and slower than English. I made the pragmatic decision to launch in English first, build the curriculum structure, and add Sinhala translations as a parallel track.

The response surprised me. Within the first month, I had a few hundred learners working through the modules. No marketing. No paid promotion. Just word of mouth — people sharing links in WhatsApp groups and on social media. The crisis had created genuine demand for this kind of education. People were searching for answers, and uvin.lk was one of the few places offering structured, free ones.

That early traction told me two things. First, the demand was real and not something I had imagined. Second, the first version was not good enough. The content was solid, but the platform needed to be a proper learning environment — not just a collection of pages.

Rebuilding in 2025 — The Full Platform

By 2025, I had the skills and the perspective to build what uvin.lk should have been from day one. The 2022 version served its purpose — it got content out during a crisis. But I wanted to build something that would last for years, scale to tens of thousands of learners, and serve as a genuine educational institution, not just a blog with a curriculum structure.

The rebuild was ground-up. New architecture, new design, new content management system, new everything. The only thing that carried over was the content itself and the domain.

The goals for the rebuild were specific:

1. Performance. The platform had to load fast on the mid-range Android devices and variable 4G connections that most Sri Lankan users have. Not fast by San Francisco standards. Fast by Colombo suburb standards.
2. Bilingual content. Full English and Sinhala support, not as an afterthought but as a core architectural decision.
3. Progressive learning paths. Learners should move through structured tracks, not wander through a random collection of articles.
4. Newsletter infrastructure. A proper email system for ongoing education beyond the website.
5. Crypto payment integration. If I am teaching people about Bitcoin, the platform should accept Bitcoin.
6. Scalability. The architecture should handle 10x the current traffic without any changes.

The Tech Stack

The stack for the 2025 rebuild is what I use across all my production projects: Next.js 15, Supabase, Tailwind CSS v4, and Vercel for deployment.

Next.js 15 was the obvious choice for the rendering layer. The App Router gives me the server component model I need — most of the platform is educational content that does not require client-side interactivity, so server components keep the JavaScript bundle small. The pages that do need interactivity — progress tracking, search, newsletter signup forms — use client components surgically. Dynamic routes handle the module and lesson structure: /learn/[module]/[lesson] maps cleanly to the content hierarchy.

Supabase handles authentication, the database, and real-time features. The PostgreSQL database stores user profiles, learning progress, newsletter subscriptions, and content metadata. Row Level Security policies ensure that users can only read and write their own progress data. Supabase Auth handles email-based signups with magic links — no passwords to forget, which matters when your target audience includes people who are not deeply technical.

Tailwind CSS v4 with the CSS-first configuration model. The design system uses CSS custom properties as design tokens — --color-primary, --color-surface, --text-primary — which makes theming and dark mode straightforward. I optimized the typography specifically for readability in long-form educational content: 18px base font size, 1.75 line height for body text, generous paragraph spacing. Reading a 2,000-word lesson on a phone should feel comfortable, not cramped.

Vercel for deployment gives me edge caching, automatic preview deployments for content updates, and serverless functions for the API routes. The ISR (Incremental Static Regeneration) strategy means content pages are statically generated at build time but can be revalidated when I update a lesson — learners always get fast loads without stale content.

The content itself lives in structured MDX files. Each lesson is a Markdown file with frontmatter metadata — title, module, order, difficulty level, estimated reading time, language. This lets me write and edit content in a text editor, version control it with Git, and have the build process handle all the rendering. No CMS admin panel to maintain, no database migrations when the content model changes.

For images and diagrams, I use a combination of optimized WebP files served through next/image and custom SVG diagrams that I create for technical concepts like transaction flows and block structures. Every image has explicit width and height attributes to prevent layout shift — CLS score is 0 across the platform.

The search functionality uses a client-side search index built at compile time. For a content library of 275 lessons, a full-text search index is small enough to ship to the client without meaningful bundle impact, and it gives instant search results without any server round-trips.

Content Strategy — 55 Modules

The curriculum is organized into 55 modules containing 275 individual lessons. This is not a random number. Each module represents a coherent topic that a learner can complete in one or two sittings, and each lesson within a module is designed to take 5 to 10 minutes to read.

The structure follows a deliberate progression:

Foundation track (Modules 1-12). What is money. The history of monetary systems. Why currencies fail. What happened in Sri Lanka — with specific data, not vague hand-waving. Inflation mechanics. Central banking. This track does not mention Bitcoin once. It builds the conceptual framework that makes Bitcoin make sense.

Bitcoin fundamentals (Modules 13-28). The whitepaper explained in plain language. Proof of work. Mining. Nodes. Wallets. Public and private keys. Transaction mechanics. Block structure. The mempool. Fees. This is the technical core, but written for someone who has never opened a terminal.

Practical Bitcoin (Modules 29-40). How to actually buy bitcoin in Sri Lanka. Exchanges that serve the local market. Wallet setup — hardware wallets, mobile wallets, the tradeoffs between convenience and security. How to verify a transaction. How to run a node. How to handle taxes and compliance in the Sri Lankan regulatory context.

Advanced topics (Modules 41-50). Lightning Network. Multisig setups. Privacy practices. Bitcoin scripting. Layer 2 solutions. Mining economics. This is for learners who have completed the earlier tracks and want deeper technical knowledge.

Economic context (Modules 51-55). Game theory and Bitcoin adoption. Monetary policy in developing nations. Bitcoin as a savings technology. The specific economic context of South Asia. These modules connect the technical knowledge back to the real-world economic problems that motivated the platform in the first place.

Every module is available in both English and Sinhala. The Sinhala translations are not automated. I write them myself or work with native Sinhala-speaking collaborators who understand both the language and the technical content. Machine-translated technical content in Sinhala is terrible — the vocabulary for cryptographic and economic concepts does not have clean one-to-one mappings, so every translation requires careful thought about how to explain the concept naturally.

CeyPay Integration — Accepting Crypto in Sri Lanka

If you are building an education platform about Bitcoin and you only accept bank transfers, you are undermining your own message. That was always clear to me. When CeyPay launched as a crypto payment solution that could serve Sri Lankan merchants, I integrated it immediately.

CeyPay allows uvin.lk to accept payments in over 50 cryptocurrencies — Bitcoin, Lightning, Ethereum, stablecoins like USDT and USDC, and dozens of others. The integration sits behind the platform's donation and premium content tipping system. The core educational content remains free. Always has been, always will be. But learners who want to support the platform or tip for a particularly useful lesson can do so using the currency they are learning about.

The technical integration was straightforward. CeyPay provides a REST API for creating payment requests and a webhook system for confirming completed payments. I built a thin wrapper around their API in a Next.js Route Handler that creates payment sessions and listens for webhook confirmations. The webhook handler validates the HMAC signature, updates the payment record in Supabase, and sends a thank-you email through the newsletter system.

What was not straightforward was the regulatory context. Sri Lanka's crypto regulation is still evolving. The Central Bank of Sri Lanka has not formally legalized or banned cryptocurrency transactions as of mid-2025, which creates an ambiguous operating environment. I made the decision to proceed because the platform is educational, the payments are voluntary donations, and CeyPay handles all the compliance on their end. But this is something I monitor continuously.

The CeyPay integration has a secondary educational purpose. When a learner makes their first crypto payment to uvin.lk, they are completing a real transaction — connecting a wallet, signing a payment, watching it confirm on-chain. That practical experience is worth more than ten lessons about how transactions work in theory.

The Newsletter

"The Bitcoin Brief: LK" started as an experiment in January 2025 and has grown to over 1,000 subscribers across 5 countries.

The name is deliberate. The "LK" positions it as Sri Lanka's Bitcoin newsletter — something that did not exist before. The format is weekly, written entirely by me, and follows a consistent structure: one macro analysis of what happened in Bitcoin that week, one deep dive into a concept from the uvin.lk curriculum, one practical tip that subscribers can act on immediately, and a curated reading list.

The subscriber base is primarily Sri Lankan, but about 30% of subscribers are from India, the UAE, the UK, and Singapore — the Sri Lankan diaspora. This was not planned but makes complete sense in retrospect. Sri Lankans working abroad still care deeply about economic conditions at home, and many of them are looking for ways to help family members back home preserve value in an unstable monetary environment.

The newsletter runs on a custom setup built on Supabase. Subscriber data lives in a PostgreSQL table with RLS policies. The sending infrastructure uses a combination of Supabase Edge Functions and a transactional email provider. I built the subscription flow to use double opt-in with email verification — a requirement for deliverability and also just good practice.

Open rates average around 42%, which is significantly above industry benchmarks for newsletter content. I attribute this to the tight topic focus and the fact that subscribers self-selected — nobody ends up on "The Bitcoin Brief: LK" by accident. Every subscriber actively chose to learn about Bitcoin in a Sri Lankan context.

The Book — The Rise of Bitcoin

In late 2024, I compiled and expanded the foundational modules of uvin.lk into a standalone ebook: "The Rise of Bitcoin." It is over 180 pages, covers the history of money through to the technical architecture of the Bitcoin network, and is written in the same plain-language style as the platform content.

The book exists for two reasons. First, not everyone learns well from a web platform. Some people prefer to read linearly, on a Kindle or as a PDF, without clicking through module structures. The book serves that audience. Second, it is a credibility artifact. When I introduce uvin.lk to potential partners, educational institutions, or event organizers, a published book signals that the platform is a serious educational resource and not a side project with a landing page.

The writing process took about four months. It was not a simple copy-paste from the website. The web content is modular — each lesson stands alone. The book needed narrative flow, transitional passages, and a progressive argument that builds across chapters. I rewrote most of the content to work in long-form, added new sections on monetary history that were too long for individual web lessons, and included charts and data visualizations specific to Sri Lanka's economic data.

Distribution is through the uvin.lk platform itself. The ebook is available as a free download — consistent with the platform's mission of free education. I also attended Token 2049 in 2024, which was a significant milestone. Being at one of the largest crypto conferences in the world, representing a Bitcoin education platform from Sri Lanka, was a reminder that what I am building matters beyond my immediate community.

What I Learned About Building Education Products

Three years of building and running uvin.lk has taught me things that no technical blog post or startup advice thread covers.

Free does not mean low quality. Every decision I made assumed that free content would be held to a higher standard by learners, not a lower one. When you charge for a course, people rationalize imperfections — "I paid $50, so it must be good." When content is free, people judge it purely on quality. The bar is actually higher.

Bilingual content doubles the work but triples the reach. Writing in Sinhala is not a translation task. It is a rewriting task. Technical concepts need to be re-explained from scratch in a language that does not have established terminology for cryptographic primitives. But the reach into communities that would never engage with English-only content makes it worth every hour.

Consistency matters more than virality. uvin.lk has never had a viral moment. No single post that got a million views. The growth has been steady — a few hundred new learners each month, every month, for three years. That compounds in a way that a single viral spike does not.

The crisis context is permanent. I originally built uvin.lk as a response to the 2022 crisis. But the structural problems that caused the crisis — excessive government borrowing, currency debasement, capital controls — have not been fully resolved. The education remains relevant because the underlying conditions remain relevant. This is not a product that served a moment. It serves a condition.

Build the content before the platform. If I were starting over, I would write 20 lessons in Google Docs before touching a single line of code. The platform is a delivery mechanism. The content is the product. Too many education startups build beautiful platforms with thin content. The order should be reversed.

Community is the moat. The 10,000+ learners and 1,000+ newsletter subscribers are not just numbers. They are a community that shares content, asks questions, recommends uvin.lk to friends, and provides feedback that shapes the curriculum. No competitor can replicate that overnight, regardless of their tech stack or funding.

The Numbers

Here is where uvin.lk stands as of mid-2025:

These are not vanity metrics. Each number represents a design decision. 55 modules means a comprehensive curriculum, not a shallow overview. 275 lessons means granular, focused content — not 10 mega-articles. 10,000 learners means genuine adoption, not inflated sign-up counts. Two languages means real accessibility, not a checkbox.

The number I care about most is not on this table. It is the number of people who learned something from uvin.lk that changed how they think about money, savings, and economic sovereignty. That is not measurable. But every email I receive from a learner who opened their first Bitcoin wallet, or who finally understood why the rupee lost value, or who set up a Lightning node in their apartment in Colombo — that is the metric.

Key Takeaways

1. Economic crises create genuine demand for financial education. The 2022 Sri Lankan crisis was the catalyst, but the need for monetary literacy is permanent in developing economies.
2. Free, structured education compounds. 10,000+ learners came through consistent content delivery over three years, not a marketing budget.
3. Bilingual content is not a feature — it is a moral obligation when your audience includes people who think and learn in a language other than English.
4. Accept the currency you teach about. CeyPay integration with 50+ cryptocurrencies is not just practical — it is educational.
5. Write the content first, build the platform second. The curriculum is the product. The tech stack is the delivery mechanism.
6. A published resource creates credibility. "The Rise of Bitcoin" at 180+ pages signals institutional seriousness.
7. Attend the conferences. Token 2049 connected uvin.lk to the global Bitcoin community in ways that no amount of online presence could.

*Uvin Vindula is a Web3 and AI engineer based in Sri Lanka and the UK. He builds uvin.lk↗, Sri Lanka's free Bitcoin education platform, and publishes "The Bitcoin Brief: LK" newsletter. He is the author of "The Rise of Bitcoin" and has attended Token 2049 2024. He writes about Bitcoin, Web3 development, and building products at iamuvin.com↗. Connect at @iamuvin↗ or contact@uvin.lk↗.*