<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Jose Sebastian on Medium]]></title>
        <description><![CDATA[Stories by Jose Sebastian on Medium]]></description>
        <link>https://medium.com/@joesaby?source=rss-5f95ce3bed8d------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/0*1hmAnUerilOveUD_.</url>
            <title>Stories by Jose Sebastian on Medium</title>
            <link>https://medium.com/@joesaby?source=rss-5f95ce3bed8d------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sat, 21 Nov 2026 10:01:35 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@joesaby/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[85K npm Downloads Later, JavaScript Still Isn’t My Language]]></title>
            <link>https://medium.com/@joesaby/85k-npm-downloads-later-javascript-still-isnt-my-language-946822772dc5?source=rss-5f95ce3bed8d------2</link>
            <guid isPermaLink="false">https://medium.com/p/946822772dc5</guid>
            <category><![CDATA[artificial-intelligence]]></category>
            <category><![CDATA[astros]]></category>
            <category><![CDATA[software-development]]></category>
            <category><![CDATA[open-source]]></category>
            <dc:creator><![CDATA[Jose Sebastian]]></dc:creator>
            <pubDate>Fri, 13 Feb 2026 15:07:03 GMT</pubDate>
            <atom:updated>2026-02-13T15:12:47.725Z</atom:updated>
            <content:encoded><![CDATA[<p>I’ve spent most of my career in VoIP protocols, enterprise Java, and Python. TypeScript and JavaScript were never part of my toolkit. So I’m still a bit puzzled that I ended up maintaining two Astro integrations — one of them with over 85,000 npm downloads.</p><h3>The Documentation Itch</h3><p>Late 2024, I was looking to move my team’s documentation off MkDocs. That search led me to Astro Starlight. The framework was fast, the developer experience was great, and the Discord community was genuinely helpful.</p><p>As I got comfortable with Starlight, I noticed Mermaid diagram support was a pain point. The existing approaches involved rehype workarounds, Puppeteer for server-side rendering, or other complex setups. There was an open community discussion about it, and nothing felt clean. I figured I could build something better — a proper integration that just works with zero config.</p><p>The catch: I’d need to write it in JavaScript.</p><h3>Making the Hours Count</h3><p>At work, I’d been using VSCode with Copilot — it had already changed how I approached everyday coding. So when I started these projects on my own time, I picked up Claude Code for the job.</p><p>JavaScript wasn’t a problem to solve, it was just a different language. The real constraint was time. I have a full-time job, and open source doesn’t happen during work hours. Claude Code let me move fast — I could get up to speed on the Astro integration API, Vite internals, remark/rehype plugin architecture, Netlify deployments, and npm packaging without spending weeks on each. More building, less context-switching through documentation.</p><p>To put it in perspective: both projects together have about 37 commits. Those 37 commits delivered two npm packages, a dual remark/rehype plugin system, auto theme switching, TypeScript definitions, a CLI tool, Vitest test suites, four Netlify demo sites, and GitHub Actions pipelines. For someone learning the Astro integration API, Vite internals, remark/rehype, npm publishing, Netlify, and GitHub Actions all from scratch — that’s probably two to three months of evenings and weekends without AI tooling. With Claude Code, it was closer to a few focused weeks.</p><h3>What I Built</h3><p><strong>astro-mermaid</strong> — renders Mermaid diagrams in Astro with automatic theme switching and client-side rendering. Privacy-focused: nothing leaves the browser. Works across .md, .mdx, and .astro files.</p><p><strong>astro-plantuml</strong> — PlantUML rendering for Astro with server-based generation, local caching, and a CLI for pre-generating diagrams.</p><p>Both ended up on the official Starlight plugins page. astro-mermaid currently sits at ~18,000 weekly npm installs, 71 GitHub stars, and 13 forks. astro-plantuml is smaller but has steady adoption.</p><p>This was effectively my first real open-source involvement.</p><h3>What I Took Away</h3><p>The biggest thing was time. AI tooling — Copilot at work, Claude Code for personal projects — made open source outside working hours actually feasible. The domain knowledge from enterprise systems — build pipelines, plugin architectures, privacy and security thinking — transferred more than I expected. The language was new, but the engineering problems weren’t.</p><p>The Starlight community also deserves credit. They pointed me toward the right problems to solve and gave early feedback that shaped both projects.</p><p>If you’re working in one stack but see a gap in another ecosystem, the barrier to crossing over is lower than it used to be. That’s not a pitch — it’s just what happened.</p><p><a href="https://github.com/joesaby/astro-mermaid"><em>astro-mermaid</em></a><em> · </em><a href="https://github.com/joesaby/astro-plantuml"><em>astro-plantuml</em></a><em> · Demos at </em><a href="https://starlight-mermaid-demo.netlify.app/"><em>starlight-mermaid-demo.netlify.app</em></a><em> and </em><a href="https://astro-plantuml-demo.netlify.app/"><em>astro-plantuml-demo.netlify.app</em></a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=946822772dc5" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>