[{"data":1,"prerenderedAt":3943},["ShallowReactive",2],{"page-en-\u002Fposts":3,"posts-en":27},{"id":4,"title":5,"body":6,"date":16,"description":17,"duration":16,"extension":18,"meta":19,"navigation":20,"path":21,"robots":16,"seo":22,"sitemap":23,"stem":24,"tags":16,"toc":25,"__hash__":26},"content_en\u002Fposts\u002Findex.md","Blog - Rasten Remizov",{"type":7,"value":8,"toc":12},"minimark",[9],[10,11],"posts-list",{},{"title":13,"searchDepth":14,"depth":14,"links":15},"",2,[],null,"Blog by Rasten Remizov — thoughts on software, life, and anything worth writing about","md",{},true,"\u002Fposts",{"title":5,"description":17},{"loc":21},"posts\u002Findex",false,"9DiRSyZkR8ewuO_5DBu6B40CdS_dfCd7NQexzsFglCg",[28,1703,1748,2033,2536,3237,3742],{"id":29,"title":30,"body":31,"date":1692,"description":1693,"duration":1694,"extension":18,"meta":1695,"navigation":20,"path":1696,"robots":16,"seo":1697,"sitemap":1698,"stem":1699,"tags":1700,"toc":20,"__hash__":1702},"content_en\u002Fposts\u002Fessential-frontend-automations.md","Essential frontend automations",{"type":7,"value":32,"toc":1677},[33,40,47,52,56,59,63,66,82,86,89,94,105,111,125,139,142,169,173,186,189,193,201,260,274,285,288,308,311,314,317,321,324,333,355,367,379,383,386,399,422,428,432,435,438,447,451,466,475,484,487,808,920,927,1102,1105,1109,1112,1115,1130,1133,1373,1505,1512,1634,1663,1666,1670,1673],[34,35,36],"h1",{"id":13},[37,38],"binding",{"value":39},"title",[41,42],"posts-date-duration",{":duration":43,":date":44,"className":45},"duration","date",[46],"-mt-6",[48,49,51],"h2",{"id":50},"introduction","Introduction",[53,54,55],"p",{},"After years of frontend work I've tried lots of automation tools — some turned out to be more hype than useful, and some turned out to be gems hidden in the sand.",[53,57,58],{},"Today I'll share my favorite automations, which I consider useful (some of them even essential). I've thoroughly used and tested them in production, and some of them differ from the common pipeline.",[48,60,62],{"id":61},"disclaimer","Disclaimer",[53,64,65],{},"I intentionally don't mention any LLM automations for several reasons:",[67,68,69,73,76,79],"ul",{},[70,71,72],"li",{},"There are lots of LLM automations — enough for another 1–2 articles",[70,74,75],{},"I haven't had enough experience testing LLM automations in production",[70,77,78],{},"LLM automations keep appearing, changing, and evolving",[70,80,81],{},"Current automations can be used inside LLM agents, so they complement each other",[48,83,85],{"id":84},"automations","Automations",[53,87,88],{},"This article is structured from more common\u002Ffamous tools to less known ones. You can use the TOC on the left to jump to the area of frontend development you're interested in.",[90,91,93],"h3",{"id":92},"linting-and-formatting-eslint-eslint-stylistic","Linting and formatting = ESLint + ESLint Stylistic",[53,95,96,97,104],{},"The most obvious automation is of course ",[98,99,103],"a",{"href":100,"rel":101},"https:\u002F\u002Feslint.org\u002F",[102],"nofollow","ESLint",".",[106,107,108],"blockquote",{},[53,109,110],{},"Wait, where's Prettier?",[53,112,113,114,119,120,104],{},"Yes, there's no ",[98,115,118],{"href":116,"rel":117},"https:\u002F\u002Fprettier.io\u002F",[102],"Prettier",". In my opinion it is better to use ",[98,121,124],{"href":122,"rel":123},"https:\u002F\u002Feslint.style\u002F",[102],"ESLint Stylistic",[53,126,127,128,133,134,138],{},"You can read about this in ",[98,129,132],{"href":130,"rel":131},"https:\u002F\u002Fantfu.me\u002Fposts\u002Fwhy-not-prettier",[102],"Why I don't use Prettier",", but my general issue is: ",[135,136,137],"strong",{},"if you don't like Prettier's styling, you will fight it and work around it",". Some behavior can't be configured in a fine-grained way, and some can't be overridden at all. ESLint gives much more flexibility where it's needed without compromising useful features.",[53,140,141],{},"If you haven't tried this workflow, I would definitely recommend giving it a try.",[53,143,144,145,150,151,156,157,162,163,168],{},"Also take a look at ",[98,146,149],{"href":147,"rel":148},"https:\u002F\u002Foxc.rs\u002Fdocs\u002Fguide\u002Fusage\u002Flinter",[102],"Oxlint"," and ",[98,152,155],{"href":153,"rel":154},"https:\u002F\u002Foxc.rs\u002Fdocs\u002Fguide\u002Fusage\u002Fformatter",[102],"Oxfmt",". At the time this article was written, Oxlint doesn't support many ESLint rules (",[98,158,161],{"href":159,"rel":160},"https:\u002F\u002Fgithub.com\u002Foxc-project\u002Foxc\u002Fissues\u002F481",[102],"general",", ",[98,164,167],{"href":165,"rel":166},"https:\u002F\u002Fgithub.com\u002Foxc-project\u002Foxc\u002Fissues\u002F15761",[102],"vue","), but that might change soon.",[90,170,172],{"id":171},"testing-playwright-nightly-smokes","Testing = Playwright + nightly smokes",[53,174,175,176,179,180,185],{},"Testing has lots of different automations, but one I think is underestimated: ",[135,177,178],{},"E2E nightly smokes",". Smoke tests are a small set of E2E cases that cover the most popular flows in your product. If you want that product to be as stable as possible, run them every night. I find ",[98,181,184],{"href":182,"rel":183},"https:\u002F\u002Fplaywright.dev\u002F",[102],"Playwright"," the best for E2E at the moment — strong support from Microsoft, better readability than Cypress, and all the major integrations.",[53,187,188],{},"The coolest and most underrated upside is catching regressions in a common workflow before the next workday — often before anyone else notices. If nobody noticed, it \"never happened\". A clean nightly history is also a solid argument when you talk about reliability or promotion.",[90,190,192],{"id":191},"code-quality-knip-husky","Code quality = Knip + Husky",[53,194,195,200],{},[98,196,199],{"href":197,"rel":198},"https:\u002F\u002Fknip.dev\u002F",[102],"Knip"," lets you check your code for a dead one. The issue with Knip is that it needs extra configuration if you use auto-imports — those files look unused by default. A minimal fix is to mark them as entry points or ignore them:",[202,203,207],"pre",{"className":204,"code":205,"language":206,"meta":13,"style":13},"language-json shiki shiki-themes github-light github-dark","{\n  \"entry\": [\"src\u002Fmain.ts\", \"src\u002Fcomponents\u002F**\u002F*.vue\"],\n  \"ignore\": [\"src\u002Fauto-imports.d.ts\"]\n}\n","json",[208,209,210,219,240,254],"code",{"__ignoreMap":13},[211,212,215],"span",{"class":213,"line":214},"line",1,[211,216,218],{"class":217},"sVt8B","{\n",[211,220,221,225,228,232,234,237],{"class":213,"line":14},[211,222,224],{"class":223},"sj4cs","  \"entry\"",[211,226,227],{"class":217},": [",[211,229,231],{"class":230},"sZZnC","\"src\u002Fmain.ts\"",[211,233,162],{"class":217},[211,235,236],{"class":230},"\"src\u002Fcomponents\u002F**\u002F*.vue\"",[211,238,239],{"class":217},"],\n",[211,241,243,246,248,251],{"class":213,"line":242},3,[211,244,245],{"class":223},"  \"ignore\"",[211,247,227],{"class":217},[211,249,250],{"class":230},"\"src\u002Fauto-imports.d.ts\"",[211,252,253],{"class":217},"]\n",[211,255,257],{"class":213,"line":256},4,[211,258,259],{"class":217},"}\n",[53,261,262,267,268,273],{},[98,263,266],{"href":264,"rel":265},"https:\u002F\u002Ftypicode.github.io\u002Fhusky\u002F",[102],"Husky"," lets you run commands on git hooks — most often pre-commit. Common use cases are running ",[98,269,272],{"href":270,"rel":271},"https:\u002F\u002Fgithub.com\u002Flint-staged\u002Flint-staged",[102],"lint-staged"," so only staged files get linted, or checking that commit messages follow a convention.",[53,275,276,277,280,281,284],{},"That said, hot take — ",[135,278,279],{},"I wouldn't use Husky",", or at bare minimum ",[135,282,283],{},"I wouldn't block commits with it",". CI already gives you access to the same checks, with a controlled way to override them when you need to.",[53,286,287],{},"Enforcing blocking pre-commit hooks in private teams is rarely worth it:",[289,290,291,302,305],"ol",{},[70,292,293,294,297,298,301],{},"These rules can be easily disabled with ",[208,295,296],{},"HUSKY=0"," (or ",[208,299,300],{},"--no-verify",") without any trace or report.",[70,303,304],{},"If skipping them is somehow blocked (custom git wrappers, enforced hook policies, etc.), then glhf with hotfixes you need to release ASAP — just imagine explaining to a manager that you haven't released the fix due to an ESLint error. Also it makes temporary commits unavailable (I often use them).",[70,306,307],{},"Even disabling doesn't fully turn Husky rules off — e.g. a user can just delete the rules or Husky on their machine.",[53,309,310],{},"As a result, congrats: you made the workflow much worse by creating a half-secure pipeline.",[53,312,313],{},"Treating local Husky hooks as a real security boundary is a bit like storing a JWT secret in the browser. In interviews, if teams has a blocking Husky rules, I really consider this as a yellow-to-red flag.",[53,315,316],{},"Please, use Husky only if you know what you're doing.",[90,318,320],{"id":319},"dependency-versioning-taze-renovate","Dependency versioning = taze + Renovate",[53,322,323],{},"Managing dependencies is relatively easy, but it should be done repeatedly. If we could automate some of its parts even a little bit — we would get a big improvement long term.",[53,325,326,327,332],{},"You can check each package manually, or you could use ",[98,328,331],{"href":329,"rel":330},"https:\u002F\u002Fgithub.com\u002Fantfu-collective\u002Ftaze",[102],"taze",". Taze lets you check which packages have updates, categorize them by semver (major, minor, patch), and auto-apply them:",[202,334,338],{"className":335,"code":336,"language":337,"meta":13,"style":13},"language-bash shiki shiki-themes github-light github-dark","pnpm dlx taze -w\n","bash",[208,339,340],{"__ignoreMap":13},[211,341,342,346,349,352],{"class":213,"line":214},[211,343,345],{"class":344},"sScJk","pnpm",[211,347,348],{"class":230}," dlx",[211,350,351],{"class":230}," taze",[211,353,354],{"class":223}," -w\n",[53,356,357,358,363,364,104],{},"As an alternative you could use the ",[98,359,362],{"href":360,"rel":361},"https:\u002F\u002Fdocs.renovatebot.com\u002F",[102],"Renovate"," bot (or any similar one). It lets you create PRs automatically while managing your ",[208,365,366],{},"package.json",[53,368,369,370,372,373,378],{},"I honestly prefer ",[135,371,331],{}," as it works with ",[98,374,377],{"href":375,"rel":376},"https:\u002F\u002Fpnpm.io\u002Fcatalogs",[102],"pnpm catalogs"," and I like to test the build locally after each package update just to be sure. But both choices are solid for production in my opinion.",[90,380,382],{"id":381},"manage-monorepo-turborepo-pnpm","Manage monorepo = Turborepo + pnpm",[53,384,385],{},"Monorepos have a dark history — they were mostly a collection of workarounds to make all repos work together. Right now monorepos are much easier, but still harder to manage than a simple repo.",[53,387,388,389,150,394,398],{},"I've created and maintained many monorepos and I find ",[98,390,393],{"href":391,"rel":392},"https:\u002F\u002Fturbo.build\u002F",[102],"Turborepo",[98,395,345],{"href":396,"rel":397},"https:\u002F\u002Fpnpm.io\u002F",[102]," extremely useful.",[53,400,401,402,405,406,162,411,162,416,421],{},"I honestly think that ",[135,403,404],{},"pnpm should be used instead of npm by default"," in any repo — it's just faster and more space-efficient. Just some sources: ",[98,407,410],{"href":408,"rel":409},"https:\u002F\u002Fdev.to\u002Fpockit_tools\u002Fpnpm-vs-npm-vs-yarn-vs-bun-the-2026-package-manager-showdown-51dc",[102],"pnpm vs npm vs yarn vs Bun",[98,412,415],{"href":413,"rel":414},"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=ZIKDJBrk56k",[102],"I Finally Changed Package Managers",[98,417,420],{"href":418,"rel":419},"https:\u002F\u002Fantfu.me\u002Fposts\u002Fcategorize-deps",[102],"Categorize Your Dependencies",". As for monorepos — pnpm is already established as a standard, where npm is trying to keep up (e.g. npm added workspaces only in 2020 and still doesn't have catalogs).",[53,423,424,427],{},[98,425,393],{"href":391,"rel":426},[102]," is a configurable build system which adds lots of features like build cache (so you wouldn't rebuild your workspace packages every time you rebuild the facade app) and a central command orchestrator (so you can run lint on all workspaces).",[90,429,431],{"id":430},"manage-package-versions-changesets","Manage package versions = Changesets",[53,433,434],{},"Managing versions for packages is much harder than you might initially think. You have to implement the desired change, test it, calculate which semver modification it belongs to, build and release the package, and then update the changelog. Repeat for the next version.",[53,436,437],{},"It becomes more complicated if we consider that we may want to batch changes before release, automate changelog updates, calculate the actual semver bump (if we had several changes with different semver levels), and — by the end — make this work collaborative.",[53,439,440,441,446],{},"I consider ",[98,442,445],{"href":443,"rel":444},"https:\u002F\u002Fgithub.com\u002Fchangesets\u002Fchangesets",[102],"Changesets"," to be the best tool for this case. Changesets lets you automate all these processes. You just need to fill a simple CLI form on each change. After that, the whole release pipeline can be automated as finely as you like.",[90,448,450],{"id":449},"generate-backend-endpoints-openapi-orval","Generate backend endpoints = OpenAPI + Orval",[53,452,453,454,459,460,465],{},"What if we want full type safety and endpoint synchronization between our backend and frontend? In SSR frameworks we can use tools like ",[98,455,458],{"href":456,"rel":457},"https:\u002F\u002Ftrpc.io\u002F",[102],"tRPC"," or Nuxt's auto-typed ",[98,461,464],{"href":462,"rel":463},"https:\u002F\u002Fnuxt.com\u002Fdocs\u002Fapi\u002Fcomposables\u002Fuse-fetch",[102],"useFetch"," composable. We can't apply the same methods though if we have a standard old-school SPA with a frontend team and a Java\u002FPHP\u002Fany-other-language backend team.",[53,467,468,469,474],{},"Tools like ",[98,470,473],{"href":471,"rel":472},"https:\u002F\u002Fgraphql.org\u002F",[102],"GraphQL"," exist, but what if you want just typed REST clients without adopting GraphQL? If you have such a case, you probably already have OpenAPI documentation from the backend to power Swagger. We can use codegen to take those same docs and generate Zod schemas, types, and even fetch services.",[53,476,477,478,483],{},"The best one in my opinion is ",[98,479,482],{"href":480,"rel":481},"https:\u002F\u002Forval.dev\u002F",[102],"Orval",". Orval is a codegen which takes OpenAPI docs and generates all of the above, plus nice docs and easy-to-use configuration.",[53,485,486],{},"Here's a concrete before \u002F after. Start with a tiny OpenAPI spec and an Orval config:",[202,488,492],{"className":489,"code":490,"language":491,"meta":13,"style":13},"language-yaml shiki shiki-themes github-light github-dark","# openapi.yaml\nopenapi: 3.0.3\ninfo:\n  title: Users API\n  version: 1.0.0\npaths:\n  \u002Fusers\u002F{id}:\n    get:\n      operationId: getUser\n      parameters:\n        - name: id\n          in: path\n          required: true\n          schema:\n            type: string\n      responses:\n        '200':\n          description: OK\n          content:\n            application\u002Fjson:\n              schema:\n                $ref: '#\u002Fcomponents\u002Fschemas\u002FUser'\ncomponents:\n  schemas:\n    User:\n      type: object\n      required: [id, email]\n      properties:\n        id:\n          type: string\n        email:\n          type: string\n          format: email\n","yaml",[208,493,494,500,512,520,530,541,549,557,565,576,584,598,609,620,628,639,647,655,666,674,682,690,701,709,717,725,736,754,762,770,780,788,797],{"__ignoreMap":13},[211,495,496],{"class":213,"line":214},[211,497,499],{"class":498},"sJ8bj","# openapi.yaml\n",[211,501,502,506,509],{"class":213,"line":14},[211,503,505],{"class":504},"s9eBZ","openapi",[211,507,508],{"class":217},": ",[211,510,511],{"class":223},"3.0.3\n",[211,513,514,517],{"class":213,"line":242},[211,515,516],{"class":504},"info",[211,518,519],{"class":217},":\n",[211,521,522,525,527],{"class":213,"line":256},[211,523,524],{"class":504},"  title",[211,526,508],{"class":217},[211,528,529],{"class":230},"Users API\n",[211,531,533,536,538],{"class":213,"line":532},5,[211,534,535],{"class":504},"  version",[211,537,508],{"class":217},[211,539,540],{"class":223},"1.0.0\n",[211,542,544,547],{"class":213,"line":543},6,[211,545,546],{"class":504},"paths",[211,548,519],{"class":217},[211,550,552,555],{"class":213,"line":551},7,[211,553,554],{"class":504},"  \u002Fusers\u002F{id}",[211,556,519],{"class":217},[211,558,560,563],{"class":213,"line":559},8,[211,561,562],{"class":504},"    get",[211,564,519],{"class":217},[211,566,568,571,573],{"class":213,"line":567},9,[211,569,570],{"class":504},"      operationId",[211,572,508],{"class":217},[211,574,575],{"class":230},"getUser\n",[211,577,579,582],{"class":213,"line":578},10,[211,580,581],{"class":504},"      parameters",[211,583,519],{"class":217},[211,585,587,590,593,595],{"class":213,"line":586},11,[211,588,589],{"class":217},"        - ",[211,591,592],{"class":504},"name",[211,594,508],{"class":217},[211,596,597],{"class":230},"id\n",[211,599,601,604,606],{"class":213,"line":600},12,[211,602,603],{"class":504},"          in",[211,605,508],{"class":217},[211,607,608],{"class":230},"path\n",[211,610,612,615,617],{"class":213,"line":611},13,[211,613,614],{"class":504},"          required",[211,616,508],{"class":217},[211,618,619],{"class":223},"true\n",[211,621,623,626],{"class":213,"line":622},14,[211,624,625],{"class":504},"          schema",[211,627,519],{"class":217},[211,629,631,634,636],{"class":213,"line":630},15,[211,632,633],{"class":504},"            type",[211,635,508],{"class":217},[211,637,638],{"class":230},"string\n",[211,640,642,645],{"class":213,"line":641},16,[211,643,644],{"class":504},"      responses",[211,646,519],{"class":217},[211,648,650,653],{"class":213,"line":649},17,[211,651,652],{"class":230},"        '200'",[211,654,519],{"class":217},[211,656,658,661,663],{"class":213,"line":657},18,[211,659,660],{"class":504},"          description",[211,662,508],{"class":217},[211,664,665],{"class":230},"OK\n",[211,667,669,672],{"class":213,"line":668},19,[211,670,671],{"class":504},"          content",[211,673,519],{"class":217},[211,675,677,680],{"class":213,"line":676},20,[211,678,679],{"class":504},"            application\u002Fjson",[211,681,519],{"class":217},[211,683,685,688],{"class":213,"line":684},21,[211,686,687],{"class":504},"              schema",[211,689,519],{"class":217},[211,691,693,696,698],{"class":213,"line":692},22,[211,694,695],{"class":504},"                $ref",[211,697,508],{"class":217},[211,699,700],{"class":230},"'#\u002Fcomponents\u002Fschemas\u002FUser'\n",[211,702,704,707],{"class":213,"line":703},23,[211,705,706],{"class":504},"components",[211,708,519],{"class":217},[211,710,712,715],{"class":213,"line":711},24,[211,713,714],{"class":504},"  schemas",[211,716,519],{"class":217},[211,718,720,723],{"class":213,"line":719},25,[211,721,722],{"class":504},"    User",[211,724,519],{"class":217},[211,726,728,731,733],{"class":213,"line":727},26,[211,729,730],{"class":504},"      type",[211,732,508],{"class":217},[211,734,735],{"class":230},"object\n",[211,737,739,742,744,747,749,752],{"class":213,"line":738},27,[211,740,741],{"class":504},"      required",[211,743,227],{"class":217},[211,745,746],{"class":230},"id",[211,748,162],{"class":217},[211,750,751],{"class":230},"email",[211,753,253],{"class":217},[211,755,757,760],{"class":213,"line":756},28,[211,758,759],{"class":504},"      properties",[211,761,519],{"class":217},[211,763,765,768],{"class":213,"line":764},29,[211,766,767],{"class":504},"        id",[211,769,519],{"class":217},[211,771,773,776,778],{"class":213,"line":772},30,[211,774,775],{"class":504},"          type",[211,777,508],{"class":217},[211,779,638],{"class":230},[211,781,783,786],{"class":213,"line":782},31,[211,784,785],{"class":504},"        email",[211,787,519],{"class":217},[211,789,791,793,795],{"class":213,"line":790},32,[211,792,775],{"class":504},[211,794,508],{"class":217},[211,796,638],{"class":230},[211,798,800,803,805],{"class":213,"line":799},33,[211,801,802],{"class":504},"          format",[211,804,508],{"class":217},[211,806,807],{"class":230},"email\n",[202,809,813],{"className":810,"code":811,"language":812,"meta":13,"style":13},"language-ts shiki shiki-themes github-light github-dark","\u002F\u002F orval.config.ts\nimport { defineConfig } from 'orval'\n\nexport default defineConfig({\n  api: {\n    input: '.\u002Fopenapi.yaml',\n    output: {\n      target: '.\u002Fsrc\u002Fapi\u002Fendpoints.ts',\n      client: 'fetch',\n      schemas: '.\u002Fsrc\u002Fapi\u002Fmodels',\n    },\n  },\n})\n","ts",[208,814,815,820,835,840,854,859,870,875,885,895,905,910,915],{"__ignoreMap":13},[211,816,817],{"class":213,"line":214},[211,818,819],{"class":498},"\u002F\u002F orval.config.ts\n",[211,821,822,826,829,832],{"class":213,"line":14},[211,823,825],{"class":824},"szBVR","import",[211,827,828],{"class":217}," { defineConfig } ",[211,830,831],{"class":824},"from",[211,833,834],{"class":230}," 'orval'\n",[211,836,837],{"class":213,"line":242},[211,838,839],{"emptyLinePlaceholder":20},"\n",[211,841,842,845,848,851],{"class":213,"line":256},[211,843,844],{"class":824},"export",[211,846,847],{"class":824}," default",[211,849,850],{"class":344}," defineConfig",[211,852,853],{"class":217},"({\n",[211,855,856],{"class":213,"line":532},[211,857,858],{"class":217},"  api: {\n",[211,860,861,864,867],{"class":213,"line":543},[211,862,863],{"class":217},"    input: ",[211,865,866],{"class":230},"'.\u002Fopenapi.yaml'",[211,868,869],{"class":217},",\n",[211,871,872],{"class":213,"line":551},[211,873,874],{"class":217},"    output: {\n",[211,876,877,880,883],{"class":213,"line":559},[211,878,879],{"class":217},"      target: ",[211,881,882],{"class":230},"'.\u002Fsrc\u002Fapi\u002Fendpoints.ts'",[211,884,869],{"class":217},[211,886,887,890,893],{"class":213,"line":567},[211,888,889],{"class":217},"      client: ",[211,891,892],{"class":230},"'fetch'",[211,894,869],{"class":217},[211,896,897,900,903],{"class":213,"line":578},[211,898,899],{"class":217},"      schemas: ",[211,901,902],{"class":230},"'.\u002Fsrc\u002Fapi\u002Fmodels'",[211,904,869],{"class":217},[211,906,907],{"class":213,"line":586},[211,908,909],{"class":217},"    },\n",[211,911,912],{"class":213,"line":600},[211,913,914],{"class":217},"  },\n",[211,916,917],{"class":213,"line":611},[211,918,919],{"class":217},"})\n",[53,921,922,923,926],{},"After ",[208,924,925],{},"orval",", you get typed models and a ready-to-use fetch client — no hand-written DTO mapping:",[202,928,930],{"className":810,"code":929,"language":812,"meta":13,"style":13},"\u002F\u002F src\u002Fapi\u002Fmodels\u002Fuser.ts (generated)\nexport interface User {\n  id: string\n  email: string\n}\n\n\u002F\u002F src\u002Fapi\u002Fendpoints.ts (generated, simplified)\nexport const getUser = async (id: string, options?: RequestInit): Promise\u003CUser> => {\n  const res = await fetch(`\u002Fusers\u002F${id}`, { ...options, method: 'GET' })\n  return res.json()\n}\n",[208,931,932,937,950,962,971,975,979,984,1043,1085,1098],{"__ignoreMap":13},[211,933,934],{"class":213,"line":214},[211,935,936],{"class":498},"\u002F\u002F src\u002Fapi\u002Fmodels\u002Fuser.ts (generated)\n",[211,938,939,941,944,947],{"class":213,"line":14},[211,940,844],{"class":824},[211,942,943],{"class":824}," interface",[211,945,946],{"class":344}," User",[211,948,949],{"class":217}," {\n",[211,951,952,956,959],{"class":213,"line":242},[211,953,955],{"class":954},"s4XuR","  id",[211,957,958],{"class":824},":",[211,960,961],{"class":223}," string\n",[211,963,964,967,969],{"class":213,"line":256},[211,965,966],{"class":954},"  email",[211,968,958],{"class":824},[211,970,961],{"class":223},[211,972,973],{"class":213,"line":532},[211,974,259],{"class":217},[211,976,977],{"class":213,"line":543},[211,978,839],{"emptyLinePlaceholder":20},[211,980,981],{"class":213,"line":551},[211,982,983],{"class":498},"\u002F\u002F src\u002Fapi\u002Fendpoints.ts (generated, simplified)\n",[211,985,986,988,991,994,997,1000,1003,1005,1007,1010,1012,1015,1018,1021,1024,1026,1029,1032,1035,1038,1041],{"class":213,"line":559},[211,987,844],{"class":824},[211,989,990],{"class":824}," const",[211,992,993],{"class":344}," getUser",[211,995,996],{"class":824}," =",[211,998,999],{"class":824}," async",[211,1001,1002],{"class":217}," (",[211,1004,746],{"class":954},[211,1006,958],{"class":824},[211,1008,1009],{"class":223}," string",[211,1011,162],{"class":217},[211,1013,1014],{"class":954},"options",[211,1016,1017],{"class":824},"?:",[211,1019,1020],{"class":344}," RequestInit",[211,1022,1023],{"class":217},")",[211,1025,958],{"class":824},[211,1027,1028],{"class":344}," Promise",[211,1030,1031],{"class":217},"\u003C",[211,1033,1034],{"class":344},"User",[211,1036,1037],{"class":217},"> ",[211,1039,1040],{"class":824},"=>",[211,1042,949],{"class":217},[211,1044,1045,1048,1051,1053,1056,1059,1062,1065,1067,1070,1073,1076,1079,1082],{"class":213,"line":567},[211,1046,1047],{"class":824},"  const",[211,1049,1050],{"class":223}," res",[211,1052,996],{"class":824},[211,1054,1055],{"class":824}," await",[211,1057,1058],{"class":344}," fetch",[211,1060,1061],{"class":217},"(",[211,1063,1064],{"class":230},"`\u002Fusers\u002F${",[211,1066,746],{"class":217},[211,1068,1069],{"class":230},"}`",[211,1071,1072],{"class":217},", { ",[211,1074,1075],{"class":824},"...",[211,1077,1078],{"class":217},"options, method: ",[211,1080,1081],{"class":230},"'GET'",[211,1083,1084],{"class":217}," })\n",[211,1086,1087,1090,1093,1095],{"class":213,"line":578},[211,1088,1089],{"class":824},"  return",[211,1091,1092],{"class":217}," res.",[211,1094,206],{"class":344},[211,1096,1097],{"class":217},"()\n",[211,1099,1100],{"class":213,"line":586},[211,1101,259],{"class":217},[53,1103,1104],{},"The one problem I want to mention is that you need to manage collaborative work, which could change and break the types on the frontend (e.g. you are writing a hotfix and some feature is deployed on dev by the backend team, which results in your types being broken). For this case, one solution is to use an npm package with OpenAPI schemas, which would be updated and versioned by both teams.",[90,1106,1108],{"id":1107},"generate-figma-tokens-tokens-studio-style-dictionary","Generate Figma tokens = Tokens Studio + Style Dictionary",[53,1110,1111],{},"This is both the most useful and the hardest automation to set up, as it would require changing the way your design team works.",[53,1113,1114],{},"The major issue when you have a designed UI is keeping it in sync with changes in Figma. I've heard lots of scary stories about teams spending even 1\u002F5 of their sprints just syncing with Figma. For some reason there's a still poor versioning mechanism in Figma, and many local custom workarounds are created.",[53,1116,1117,1118,1123,1124,1129],{},"We can use ",[98,1119,1122],{"href":1120,"rel":1121},"https:\u002F\u002Ftokens.studio\u002F",[102],"Tokens Studio"," to resolve this issue. Tokens Studio is basically a Figma plugin which manages design tokens. When designers use tokens through that plugin they can export them as a schema (like OpenAPI for tokens), and then we can use ",[98,1125,1128],{"href":1126,"rel":1127},"https:\u002F\u002Fstyledictionary.com\u002F",[102],"Style Dictionary"," to render this schema into our specific CSS setup — Tailwind, CSS variables, Sass, and so on.",[53,1131,1132],{},"Concrete before \u002F after. Designers export a Tokens Studio schema, and you point Style Dictionary at it:",[202,1134,1136],{"className":204,"code":1135,"language":206,"meta":13,"style":13},"\u002F\u002F tokens\u002Fcolors.json (exported from Tokens Studio)\n{\n  \"color\": {\n    \"brand\": {\n      \"primary\": { \"value\": \"#2563eb\", \"type\": \"color\" },\n      \"secondary\": { \"value\": \"#7c3aed\", \"type\": \"color\" }\n    },\n    \"surface\": {\n      \"bg\": { \"value\": \"#ffffff\", \"type\": \"color\" },\n      \"fg\": { \"value\": \"#0f172a\", \"type\": \"color\" }\n    }\n  },\n  \"spacing\": {\n    \"sm\": { \"value\": \"8\", \"type\": \"spacing\" },\n    \"md\": { \"value\": \"16\", \"type\": \"spacing\" },\n    \"lg\": { \"value\": \"24\", \"type\": \"spacing\" }\n  }\n}\n",[208,1137,1138,1143,1147,1155,1162,1191,1216,1220,1227,1251,1275,1280,1284,1291,1316,1340,1364,1369],{"__ignoreMap":13},[211,1139,1140],{"class":213,"line":214},[211,1141,1142],{"class":498},"\u002F\u002F tokens\u002Fcolors.json (exported from Tokens Studio)\n",[211,1144,1145],{"class":213,"line":14},[211,1146,218],{"class":217},[211,1148,1149,1152],{"class":213,"line":242},[211,1150,1151],{"class":223},"  \"color\"",[211,1153,1154],{"class":217},": {\n",[211,1156,1157,1160],{"class":213,"line":256},[211,1158,1159],{"class":223},"    \"brand\"",[211,1161,1154],{"class":217},[211,1163,1164,1167,1170,1173,1175,1178,1180,1183,1185,1188],{"class":213,"line":532},[211,1165,1166],{"class":223},"      \"primary\"",[211,1168,1169],{"class":217},": { ",[211,1171,1172],{"class":223},"\"value\"",[211,1174,508],{"class":217},[211,1176,1177],{"class":230},"\"#2563eb\"",[211,1179,162],{"class":217},[211,1181,1182],{"class":223},"\"type\"",[211,1184,508],{"class":217},[211,1186,1187],{"class":230},"\"color\"",[211,1189,1190],{"class":217}," },\n",[211,1192,1193,1196,1198,1200,1202,1205,1207,1209,1211,1213],{"class":213,"line":543},[211,1194,1195],{"class":223},"      \"secondary\"",[211,1197,1169],{"class":217},[211,1199,1172],{"class":223},[211,1201,508],{"class":217},[211,1203,1204],{"class":230},"\"#7c3aed\"",[211,1206,162],{"class":217},[211,1208,1182],{"class":223},[211,1210,508],{"class":217},[211,1212,1187],{"class":230},[211,1214,1215],{"class":217}," }\n",[211,1217,1218],{"class":213,"line":551},[211,1219,909],{"class":217},[211,1221,1222,1225],{"class":213,"line":559},[211,1223,1224],{"class":223},"    \"surface\"",[211,1226,1154],{"class":217},[211,1228,1229,1232,1234,1236,1238,1241,1243,1245,1247,1249],{"class":213,"line":567},[211,1230,1231],{"class":223},"      \"bg\"",[211,1233,1169],{"class":217},[211,1235,1172],{"class":223},[211,1237,508],{"class":217},[211,1239,1240],{"class":230},"\"#ffffff\"",[211,1242,162],{"class":217},[211,1244,1182],{"class":223},[211,1246,508],{"class":217},[211,1248,1187],{"class":230},[211,1250,1190],{"class":217},[211,1252,1253,1256,1258,1260,1262,1265,1267,1269,1271,1273],{"class":213,"line":578},[211,1254,1255],{"class":223},"      \"fg\"",[211,1257,1169],{"class":217},[211,1259,1172],{"class":223},[211,1261,508],{"class":217},[211,1263,1264],{"class":230},"\"#0f172a\"",[211,1266,162],{"class":217},[211,1268,1182],{"class":223},[211,1270,508],{"class":217},[211,1272,1187],{"class":230},[211,1274,1215],{"class":217},[211,1276,1277],{"class":213,"line":586},[211,1278,1279],{"class":217},"    }\n",[211,1281,1282],{"class":213,"line":600},[211,1283,914],{"class":217},[211,1285,1286,1289],{"class":213,"line":611},[211,1287,1288],{"class":223},"  \"spacing\"",[211,1290,1154],{"class":217},[211,1292,1293,1296,1298,1300,1302,1305,1307,1309,1311,1314],{"class":213,"line":622},[211,1294,1295],{"class":223},"    \"sm\"",[211,1297,1169],{"class":217},[211,1299,1172],{"class":223},[211,1301,508],{"class":217},[211,1303,1304],{"class":230},"\"8\"",[211,1306,162],{"class":217},[211,1308,1182],{"class":223},[211,1310,508],{"class":217},[211,1312,1313],{"class":230},"\"spacing\"",[211,1315,1190],{"class":217},[211,1317,1318,1321,1323,1325,1327,1330,1332,1334,1336,1338],{"class":213,"line":630},[211,1319,1320],{"class":223},"    \"md\"",[211,1322,1169],{"class":217},[211,1324,1172],{"class":223},[211,1326,508],{"class":217},[211,1328,1329],{"class":230},"\"16\"",[211,1331,162],{"class":217},[211,1333,1182],{"class":223},[211,1335,508],{"class":217},[211,1337,1313],{"class":230},[211,1339,1190],{"class":217},[211,1341,1342,1345,1347,1349,1351,1354,1356,1358,1360,1362],{"class":213,"line":641},[211,1343,1344],{"class":223},"    \"lg\"",[211,1346,1169],{"class":217},[211,1348,1172],{"class":223},[211,1350,508],{"class":217},[211,1352,1353],{"class":230},"\"24\"",[211,1355,162],{"class":217},[211,1357,1182],{"class":223},[211,1359,508],{"class":217},[211,1361,1313],{"class":230},[211,1363,1215],{"class":217},[211,1365,1366],{"class":213,"line":649},[211,1367,1368],{"class":217},"  }\n",[211,1370,1371],{"class":213,"line":657},[211,1372,259],{"class":217},[202,1374,1378],{"className":1375,"code":1376,"language":1377,"meta":13,"style":13},"language-js shiki shiki-themes github-light github-dark","\u002F\u002F style-dictionary.config.js\nexport default {\n  source: ['tokens\u002F**\u002F*.json'],\n  platforms: {\n    css: {\n      transformGroup: 'css',\n      buildPath: 'build\u002F',\n      files: [\n        {\n          destination: 'theme.css',\n          format: 'css\u002Fvariables',\n          options: {\n            selector: '@theme',\n          },\n        },\n      ],\n    },\n  },\n}\n","js",[208,1379,1380,1385,1393,1403,1408,1413,1423,1433,1438,1443,1453,1463,1468,1478,1483,1488,1493,1497,1501],{"__ignoreMap":13},[211,1381,1382],{"class":213,"line":214},[211,1383,1384],{"class":498},"\u002F\u002F style-dictionary.config.js\n",[211,1386,1387,1389,1391],{"class":213,"line":14},[211,1388,844],{"class":824},[211,1390,847],{"class":824},[211,1392,949],{"class":217},[211,1394,1395,1398,1401],{"class":213,"line":242},[211,1396,1397],{"class":217},"  source: [",[211,1399,1400],{"class":230},"'tokens\u002F**\u002F*.json'",[211,1402,239],{"class":217},[211,1404,1405],{"class":213,"line":256},[211,1406,1407],{"class":217},"  platforms: {\n",[211,1409,1410],{"class":213,"line":532},[211,1411,1412],{"class":217},"    css: {\n",[211,1414,1415,1418,1421],{"class":213,"line":543},[211,1416,1417],{"class":217},"      transformGroup: ",[211,1419,1420],{"class":230},"'css'",[211,1422,869],{"class":217},[211,1424,1425,1428,1431],{"class":213,"line":551},[211,1426,1427],{"class":217},"      buildPath: ",[211,1429,1430],{"class":230},"'build\u002F'",[211,1432,869],{"class":217},[211,1434,1435],{"class":213,"line":559},[211,1436,1437],{"class":217},"      files: [\n",[211,1439,1440],{"class":213,"line":567},[211,1441,1442],{"class":217},"        {\n",[211,1444,1445,1448,1451],{"class":213,"line":578},[211,1446,1447],{"class":217},"          destination: ",[211,1449,1450],{"class":230},"'theme.css'",[211,1452,869],{"class":217},[211,1454,1455,1458,1461],{"class":213,"line":586},[211,1456,1457],{"class":217},"          format: ",[211,1459,1460],{"class":230},"'css\u002Fvariables'",[211,1462,869],{"class":217},[211,1464,1465],{"class":213,"line":600},[211,1466,1467],{"class":217},"          options: {\n",[211,1469,1470,1473,1476],{"class":213,"line":611},[211,1471,1472],{"class":217},"            selector: ",[211,1474,1475],{"class":230},"'@theme'",[211,1477,869],{"class":217},[211,1479,1480],{"class":213,"line":622},[211,1481,1482],{"class":217},"          },\n",[211,1484,1485],{"class":213,"line":630},[211,1486,1487],{"class":217},"        },\n",[211,1489,1490],{"class":213,"line":641},[211,1491,1492],{"class":217},"      ],\n",[211,1494,1495],{"class":213,"line":649},[211,1496,909],{"class":217},[211,1498,1499],{"class":213,"line":657},[211,1500,914],{"class":217},[211,1502,1503],{"class":213,"line":668},[211,1504,259],{"class":217},[53,1506,1507,1508,1511],{},"With ",[208,1509,1510],{},"selector: '@theme'",", Style Dictionary generates a Tailwind v4 theme file directly:",[202,1513,1517],{"className":1514,"code":1515,"language":1516,"meta":13,"style":13},"language-css shiki shiki-themes github-light github-dark","\u002F**\n * Do not edit directly, this file was auto-generated.\n *\u002F\n\n@theme {\n  --color-brand-primary: #2563eb;\n  --color-brand-secondary: #7c3aed;\n  --color-surface-bg: #ffffff;\n  --color-surface-fg: #0f172a;\n  --spacing-sm: 8;\n  --spacing-md: 16;\n  --spacing-lg: 24;\n}\n","css",[208,1518,1519,1524,1529,1534,1538,1545,1558,1570,1582,1594,1606,1618,1630],{"__ignoreMap":13},[211,1520,1521],{"class":213,"line":214},[211,1522,1523],{"class":498},"\u002F**\n",[211,1525,1526],{"class":213,"line":14},[211,1527,1528],{"class":498}," * Do not edit directly, this file was auto-generated.\n",[211,1530,1531],{"class":213,"line":242},[211,1532,1533],{"class":498}," *\u002F\n",[211,1535,1536],{"class":213,"line":256},[211,1537,839],{"emptyLinePlaceholder":20},[211,1539,1540,1543],{"class":213,"line":532},[211,1541,1542],{"class":824},"@theme",[211,1544,949],{"class":217},[211,1546,1547,1550,1552,1555],{"class":213,"line":543},[211,1548,1549],{"class":954},"  --color-brand-primary",[211,1551,508],{"class":217},[211,1553,1554],{"class":223},"#2563eb",[211,1556,1557],{"class":217},";\n",[211,1559,1560,1563,1565,1568],{"class":213,"line":551},[211,1561,1562],{"class":954},"  --color-brand-secondary",[211,1564,508],{"class":217},[211,1566,1567],{"class":223},"#7c3aed",[211,1569,1557],{"class":217},[211,1571,1572,1575,1577,1580],{"class":213,"line":559},[211,1573,1574],{"class":954},"  --color-surface-bg",[211,1576,508],{"class":217},[211,1578,1579],{"class":223},"#ffffff",[211,1581,1557],{"class":217},[211,1583,1584,1587,1589,1592],{"class":213,"line":567},[211,1585,1586],{"class":954},"  --color-surface-fg",[211,1588,508],{"class":217},[211,1590,1591],{"class":223},"#0f172a",[211,1593,1557],{"class":217},[211,1595,1596,1599,1601,1604],{"class":213,"line":578},[211,1597,1598],{"class":954},"  --spacing-sm",[211,1600,508],{"class":217},[211,1602,1603],{"class":223},"8",[211,1605,1557],{"class":217},[211,1607,1608,1611,1613,1616],{"class":213,"line":586},[211,1609,1610],{"class":954},"  --spacing-md",[211,1612,508],{"class":217},[211,1614,1615],{"class":223},"16",[211,1617,1557],{"class":217},[211,1619,1620,1623,1625,1628],{"class":213,"line":600},[211,1621,1622],{"class":954},"  --spacing-lg",[211,1624,508],{"class":217},[211,1626,1627],{"class":223},"24",[211,1629,1557],{"class":217},[211,1631,1632],{"class":213,"line":611},[211,1633,259],{"class":217},[202,1635,1637],{"className":1514,"code":1636,"language":1516,"meta":13,"style":13},"\u002F* app.css *\u002F\n@import \"tailwindcss\";\n@import \".\u002Fbuild\u002Ftheme.css\";\n",[208,1638,1639,1644,1654],{"__ignoreMap":13},[211,1640,1641],{"class":213,"line":214},[211,1642,1643],{"class":498},"\u002F* app.css *\u002F\n",[211,1645,1646,1649,1652],{"class":213,"line":14},[211,1647,1648],{"class":824},"@import",[211,1650,1651],{"class":230}," \"tailwindcss\"",[211,1653,1557],{"class":217},[211,1655,1656,1658,1661],{"class":213,"line":242},[211,1657,1648],{"class":824},[211,1659,1660],{"class":230}," \".\u002Fbuild\u002Ftheme.css\"",[211,1662,1557],{"class":217},[53,1664,1665],{},"It has the same issue with versioning the tokens, but Tokens Studio supports integration with Git so designers can easily version token changes. Then we can create an npm package where this generation would be applied and pin our frontend to that version.",[48,1667,1669],{"id":1668},"conclusion","Conclusion",[53,1671,1672],{},"I've tried to collect my favorite high-value automations, the ones that I actually kept using after trying. I hope you found something interesting and new for yourself!",[1674,1675,1676],"style",{},"html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .s9eBZ, html code.shiki .s9eBZ{--shiki-default:#22863A;--shiki-dark:#85E89D}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .s4XuR, html code.shiki .s4XuR{--shiki-default:#E36209;--shiki-dark:#FFAB70}",{"title":13,"searchDepth":14,"depth":14,"links":1678},[1679,1680,1681,1691],{"id":50,"depth":14,"text":51},{"id":61,"depth":14,"text":62},{"id":84,"depth":14,"text":85,"children":1682},[1683,1684,1685,1686,1687,1688,1689,1690],{"id":92,"depth":242,"text":93},{"id":171,"depth":242,"text":172},{"id":191,"depth":242,"text":192},{"id":319,"depth":242,"text":320},{"id":381,"depth":242,"text":382},{"id":430,"depth":242,"text":431},{"id":449,"depth":242,"text":450},{"id":1107,"depth":242,"text":1108},{"id":1668,"depth":14,"text":1669},"2026-07-21 00:00:00 UTC","Some useful automations I discovered to drastically improve the developer experience","10 min",{},"\u002Fposts\u002Fessential-frontend-automations",{"title":30,"description":1693},{"loc":1696,"lastmod":1692},"posts\u002Fessential-frontend-automations",[1701],"dev","FUb9ngo-JULHay0laH8eGE7zP1ZjZNIHCsEFAd9Gh0Q",{"id":1704,"title":1705,"body":1706,"date":1740,"description":13,"duration":1741,"extension":18,"meta":1742,"navigation":20,"path":1743,"robots":16,"seo":1744,"sitemap":1745,"stem":1746,"tags":16,"toc":25,"__hash__":1747},"content_en\u002Fposts\u002Fhello-blog.md","Hello blog!",{"type":7,"value":1707,"toc":1738},[1708,1712,1715,1718,1726,1729,1732,1735],[34,1709,1710],{"id":13},[37,1711],{"value":39},[41,1713],{":duration":43,":date":44,"className":1714},[46],[53,1716,1717],{},"At some point, I noticed that the most interesting conversations I have — about technology, about life, about why things are the way they are — disappear the moment they end. I wanted a place where I could hold onto those thoughts, even if just for myself, and come back to them when needed.",[53,1719,1720,1721,1725],{},"As for the blog, I genuinely think it will help me move forward. I want to improve my writing, learn to structure my thoughts better and collect them all in one place. I don't think it will stick to any particular topic. I'm going to write about anything I find interesting. But you can always use ",[1722,1723,1724],"em",{},"tags"," to filter for what you care about the most.",[53,1727,1728],{},"As my native language is Russian, I will write posts both in English and Russian. You can switch between them whenever you like. Both versions will have their own articles, since not all topics translate well across both audiences — and vice versa.",[53,1730,1731],{},"Anyway, this site will definitely evolve over time. I plan to add a section about the hardware and software I use, a list of my favorite media, or maybe even something I haven't thought of yet.",[53,1733,1734],{},"I hope you'll find something interesting here. Btw any suggestions are welcome!",[53,1736,1737],{},"See you next time!",{"title":13,"searchDepth":14,"depth":14,"links":1739},[],"2026-03-13 00:00:00 UTC","1 min",{},"\u002Fposts\u002Fhello-blog",{"title":1705,"description":13},{"loc":1743,"lastmod":1740},"posts\u002Fhello-blog","aUV3HsTxULFuUNYcZMnGd3b4RCZ4-nBbAuf_qMfoeiM",{"id":1749,"title":1750,"body":1751,"date":2024,"description":2025,"duration":2026,"extension":18,"meta":2027,"navigation":20,"path":2028,"robots":16,"seo":2029,"sitemap":2030,"stem":2031,"tags":16,"toc":25,"__hash__":2032},"content_en\u002Fposts\u002Finvisible-language-tax.md","The invisible language tax",{"type":7,"value":1752,"toc":2018},[1753,1757,1760,1765,1767,1773,1776,1792,1796,1808,1817,1824,1827,1833,1836,1839,1856,1859,1879,1883,1890,1893,1896,1904,1910,1913,1919,1925,1932,1954,1967,1969,1984,1986,1989,2006,2015],[34,1754,1755],{"id":13},[37,1756],{"value":39},[41,1758],{":duration":43,":date":44,"className":1759},[46],[106,1761,1762],{},[53,1763,1764],{},"I compare Russian and English simply because those are the languages I know best. Similar effects exist across other language families, but their size depends on the model and tokenizer. You can find data for other languages in the sources linked throughout the article.",[48,1766,51],{"id":50},[53,1768,1769,1770],{},"It's 2024. An office in Moscow. My fellow frontend developers and I are swapping tips and getting excited about how much faster we work with Cursor and Claude 3.5 Sonnet. Everyone has roughly the same tricks and prompts, but something stands out on my laptop - I talk to the model in English. ",[1722,1771,1772],{},"Why?",[53,1774,1775],{},"At the time, I was practicing my English. Honestly, that was the main reason. But as I learned more about how LLMs work, I started to suspect that the choice of language mattered technically, too.",[53,1777,1778,1779,1782,1783,1786,1787,104],{},"From experience, I know that many Russian-speaking developers, and plenty of others, still write prompts in their native language simply because ",[135,1780,1781],{},"\"it's easier.\""," In this post, I'll share numbers showing that they pay for that convenience ",[135,1784,1785],{},"in both money and model intelligence",", and why they might as well forget about benchmark results from sites like ",[98,1788,1791],{"href":1789,"rel":1790},"https:\u002F\u002Fartificialanalysis.ai\u002F",[102],"Artificial Analysis",[48,1793,1795],{"id":1794},"first-intelligence","First: intelligence",[53,1797,1798,1799,1804,1805,104],{},"You're looking at a new model's benchmark results, excited that Opus 5.5 has gained ",[98,1800,1803],{"href":1801,"rel":1802},"https:\u002F\u002Fartificialanalysis.ai\u002F?models=claude-opus-5-5%2Cclaude-opus-5#artificial-analysis-intelligence-index",[102],"7 points"," over Opus 5. If you write your prompts in a language other than English, ",[135,1806,1807],{},"that result is effectively meaningless for you",[53,1809,1810,1811,1816],{},"Take a look at this chart from the ",[98,1812,1815],{"href":1813,"rel":1814},"https:\u002F\u002Farxiv.org\u002Fhtml\u002F2503.10497",[102],"MMLU-ProX"," benchmark:",[1818,1819],"posts-image",{"src":1820,"width":1821,"height":1822,"alt":1823,"caption":1823},"\u002Fimages\u002Fllm-scores-per-language.jpg",1440,1438,"Best LLM scores on MMLU-ProX for each language, grouped by region",[53,1825,1826],{},"And here's the table from the same paper, which I've given a visual makeover and trimmed down to just English and Russian:",[1818,1828],{"src":1829,"width":1830,"height":1831,"alt":1832,"caption":1832},"\u002Fimages\u002Fmodel-perfomance-on-mmlu.jpg",1040,1384,"Model performance on MMLU-ProX in English and Russian (%)",[53,1834,1835],{},"To be fair, this research isn't new, and the models are relatively old. It's still the most recent study with this kind of comparison that I managed to find. Also, GPT-4o actually scored higher in Russian than in English.",[53,1837,1838],{},"So what can we take away from this?",[67,1840,1841,1847],{},[70,1842,1843,1846],{},[135,1844,1845],{},"Most models \"understand\" and \"respond\" better in English most of the time."," The gap varies from model to model, but the overall picture is worse for other languages.",[70,1848,1849,1852,1853,104],{},[135,1850,1851],{},"Most benchmarks you see on Artificial Analysis are run in English."," When you write prompts in another language, you could theoretically get results no better, or even worse, than those of a previous-generation model. In other words, Opus 5.5 could theoretically be worse than Opus 5 for YOU. Most of the time, improvements will probably carry over proportionally, but the opposite can happen too. And the scariest part is that ",[135,1854,1855],{},"you'll never know",[53,1857,1858],{},"Why does this happen? Here's the rough explanation:",[67,1860,1861,1868],{},[70,1862,1863,1864,1867],{},"Models learn from data. The more data a model has, the more accurately it will answer, assuming you're comparing it with an otherwise similar model trained on less data. ",[135,1865,1866],{},"There's simply more training data in English",", so the answers are more accurate.",[70,1869,1870,1873,1874,104],{},[135,1871,1872],{},"Knowledge doesn't always transfer reliably between languages."," A correct answer in English doesn't guarantee a correct answer to the same question in Russian. You can read more about that ",[98,1875,1878],{"href":1876,"rel":1877},"https:\u002F\u002Faclanthology.org\u002F2024.naacl-long.339\u002F",[102],"here",[48,1880,1882],{"id":1881},"second-the-tax","Second: the tax",[53,1884,1885,1886,1889],{},"Do you like taxes? Would it make your day if I told you that ",[135,1887,1888],{},"every prompt in Russian costs 2.5 times as much on average","? Why?",[53,1891,1892],{},"Tokenizers. A prompt is split into tokens, which are then converted into vectors and processed by the model. Pricing usually comes down to two rates: the price per million input tokens and the price per million output tokens.",[53,1894,1895],{},"Here's the catch: these tokenizers are heavily optimized for English. The same sentence, expressed in different languages, can be split into different numbers of tokens even though the meaning is identical.",[53,1897,1898,1899,958],{},"Take a look at this chart from a ",[98,1900,1903],{"href":1901,"rel":1902},"https:\u002F\u002Faclanthology.org\u002F2023.emnlp-main.614.pdf",[102],"2023 paper",[1818,1905],{"src":1906,"width":1907,"height":1908,"alt":1909,"caption":1909},"\u002Fimages\u002Faverage-number-of-tokens-by-language.jpg",490,312,"Average number of tokens per FLORES sentence, grouped by writing system; numbers above the lines indicate the number of languages in each group",[53,1911,1912],{},"Cyrillic takes more tokens than the Latin alphabet for the same prompt. Now remember what the bill is based on, and that the model replies in Cyrillic too. That means more tokens on both the input and output sides.",[1818,1914],{"src":1915,"width":1916,"height":1917,"alt":1918,"caption":1918},"\u002Fimages\u002Fmodel-cost-relative-to-english.jpg",960,642,"Cost by language family relative to English",[53,1920,1921,1922,104],{},"That's the ",[135,1923,1924],{},"invisible language tax",[53,1926,1927,1928,1931],{},"Again, to be fair, the study is pretty old: it dates back to 2023, all the way back to GPT-3.5. But remember, this part depends ",[135,1929,1930],{},"on the tokenizer, not the model",". And judging by newer research, things have improved, but not by much.",[53,1933,1934,1935,1940,1941,1944,1945,1950,1951,104],{},"For example, this ",[98,1936,1939],{"href":1937,"rel":1938},"https:\u002F\u002Farxiv.org\u002Fabs\u002F2609.39001",[102],"2026 paper"," found that ",[135,1942,1943],{},"French requires 31–58% more tokens than English",". Another ",[98,1946,1949],{"href":1947,"rel":1948},"https:\u002F\u002Farxiv.org\u002Fhtml\u002F2601.13328",[102],"paper"," shows that after a tokenizer update, ",[135,1952,1953],{},"Hindi's token overhead fell from 4.83× with GPT-3.5\u002F4 to 1.59× with GPT-4o",[53,1955,1956,1957,1962,1963,1966],{},"And here's a recent ",[98,1958,1961],{"href":1959,"rel":1960},"https:\u002F\u002Fteletype.in\u002F@khaskydev\u002Fnon-english-prompts-cost-more-tokens",[102],"article"," showing that ",[135,1964,1965],{},"Opus 5 uses 200% more tokens in Russian"," for prompts with the same meaning.",[53,1968,1838],{},[67,1970,1971,1977],{},[70,1972,1973,1976],{},[135,1974,1975],{},"The same request costs more on average if you use any language other than English."," In other words, you burn through your subscription limits faster.",[70,1978,1979,1980,1983],{},"Context windows are limited by token count. If Russian text takes more tokens, ",[135,1981,1982],{},"less information fits in the same window",", and agents may need to compact their context sooner.",[48,1985,1669],{"id":1668},[53,1987,1988],{},"For everyday tasks, you may never notice the difference. But if you work with agents and large contexts all the time, your choice of language deserves attention.",[53,1990,1991,1992,1995,1996,1999,2000,2002,2003,2005],{},"With the rise of AI, ",[135,1993,1994],{},"knowing English has only become more important",". Code is already written using the Latin alphabet. All code comments ",[135,1997,1998],{},"must"," be in English because they go into the context. Documentation that an agent might use ",[135,2001,1998],{}," be in English because it goes into the context. Your prompts ",[135,2004,1998],{}," be in English too, because they create that context.",[53,2007,2008,2009,2014],{},"There's a chart called ",[98,2010,2013],{"href":2011,"rel":2012},"https:\u002F\u002Fartificialanalysis.ai\u002F#intelligence-comparison-tabs",[102],"Intelligence Index vs. Cost per Intelligence Index Task"," that many people use to pick models offering the best value for money. If you keep writing prompts in Russian, every time you look at it, mentally move your model's dot to the right and down, where things are more expensive and dumber. That will be your tax for \"it's easier.\"",[53,2016,2017],{},"Use English, please.",{"title":13,"searchDepth":14,"depth":14,"links":2019},[2020,2021,2022,2023],{"id":50,"depth":14,"text":51},{"id":1794,"depth":14,"text":1795},{"id":1881,"depth":14,"text":1882},{"id":1668,"depth":14,"text":1669},"2026-10-17 00:00:00 UTC","Or how to get less AI for more money","5 min",{},"\u002Fposts\u002Finvisible-language-tax",{"title":1750,"description":2025},{"loc":2028,"lastmod":2024},"posts\u002Finvisible-language-tax","xFych6ctxp9YvhX6srJX8-zvHmS1Y-7FFiYzi_Bv5zU",{"id":2034,"title":2035,"body":2036,"date":2526,"description":2527,"duration":2528,"extension":18,"meta":2529,"navigation":20,"path":2530,"robots":16,"seo":2531,"sitemap":2532,"stem":2533,"tags":2534,"toc":20,"__hash__":2535},"content_en\u002Fposts\u002Fstop-using-html-for-your-resume.md","Stop using HTML for your resume",{"type":7,"value":2037,"toc":2512},[2038,2042,2045,2047,2055,2120,2124,2127,2131,2134,2149,2152,2156,2167,2192,2195,2199,2202,2233,2237,2240,2243,2247,2252,2267,2277,2286,2317,2321,2324,2334,2348,2351,2360,2372,2399,2402,2404,2414,2417,2421,2424,2429,2455,2460,2478,2486,2488,2500,2509],[34,2039,2040],{"id":13},[37,2041],{"value":39},[41,2043],{":duration":43,":date":44,"className":2044},[46],[48,2046,62],{"id":61},[53,2048,2049,2050,2054],{},"This post is a logical continuation of ",[98,2051,2053],{"href":2052},"\u002Fposts\u002Fstop-using-word-for-your-resume","Stop using Word for your resume",". I strongly recommend reading that post first for full context, but I will still recap the main points:",[289,2056,2057,2068,2106,2112],{},[70,2058,2059,2060,2063,2064,2067],{},"A resume should have a ",[135,2061,2062],{},"single local"," source of truth in an easy-to-edit ",[135,2065,2066],{},"raw"," format.",[70,2069,2070,2071,162,2074,162,2077,2080,2081,2084,2085,162,2088,162,2091,2080,2094,2097,2098,2101,2102,2105],{},"That raw format should be ",[135,2072,2073],{},"transformable to PDF",[135,2075,2076],{},"LLM and ATS friendly",[135,2078,2079],{},"version-controllable",", and ",[135,2082,2083],{},"portable",", with ",[135,2086,2087],{},"precise layout control",[135,2089,2090],{},"rich and flexible styling",[135,2092,2093],{},"easy-to-author content",[135,2095,2096],{},"separation of content and style",". We assume the user is a ",[135,2099,2100],{},"developer"," and\u002For ",[135,2103,2104],{},"can or wants to learn"," that format.",[70,2107,2108,2111],{},[135,2109,2110],{},"HTML"," fits the role, but didn't have the required tooling.",[70,2113,2114,2119],{},[98,2115,2118],{"href":2116,"rel":2117},"https:\u002F\u002Fcv-html-dev.netlify.app",[102],"CV.html"," was created to fill this gap.",[48,2121,2123],{"id":2122},"issues","Issues",[53,2125,2126],{},"Since then, I've been using my tool a lot, experimenting with different styles, content, visual designs, and so on. While it all sounds good on paper, in practice some unexpected issues appeared.",[90,2128,2130],{"id":2129},"repeating","Repeating",[53,2132,2133],{},"Resume structure is inherently repetitive — job entries, bullet points, skills lists — but plain HTML gives you no way to express that. For example, achievements inside a work experience entry, or the work experience entries themselves.",[53,2135,2136,2137,2142,2143,2148],{},"Technically, it's a two-level-deep list, and while in day-to-day work we'd use loop rendering and component abstraction, plain HTML doesn't give you those tools. You could extract some markup into a ",[98,2138,2141],{"href":2139,"rel":2140},"https:\u002F\u002Fdeveloper.mozilla.org\u002Fen-US\u002Fdocs\u002FWeb\u002FAPI\u002FWeb_components\u002FUsing_custom_elements",[102],"custom element",", but you'd still repeat it many times in code, bloating the file and running into everything you've heard about the ",[98,2144,2147],{"href":2145,"rel":2146},"https:\u002F\u002Fen.wikipedia.org\u002Fwiki\u002FDon%27t_repeat_yourself",[102],"DRY"," principle.",[53,2150,2151],{},"Also, who wants to write web components for their resume?",[90,2153,2155],{"id":2154},"images","Images",[53,2157,2158,2159,2162,2163,2166],{},"It's common to add a photo to a resume in some countries, and the most portable way to embed one in HTML is to convert it to a base64 string. If you've ever seen an encoded image, you know it can get really big. In the current setup, a user has to paste it into an ",[208,2160,2161],{},"img"," tag as the ",[208,2164,2165],{},"src"," attribute:",[202,2168,2172],{"className":2169,"code":2170,"language":2171,"meta":13,"style":13},"language-html shiki shiki-themes github-light github-dark","\u003Cimg src=\"data:image\u002F[format];base64,[your_base64_string]\" \u002F>\n","html",[208,2173,2174],{"__ignoreMap":13},[211,2175,2176,2178,2180,2183,2186,2189],{"class":213,"line":214},[211,2177,1031],{"class":217},[211,2179,2161],{"class":504},[211,2181,2182],{"class":344}," src",[211,2184,2185],{"class":217},"=",[211,2187,2188],{"class":230},"\"data:image\u002F[format];base64,[your_base64_string]\"",[211,2190,2191],{"class":217}," \u002F>\n",[53,2193,2194],{},"That combines perfectly with the previous issue, making your HTML even more bloated. Now imagine rendering the same image several times (as in the work experience list case). Even thinking about it gives me a headache.",[90,2196,2198],{"id":2197},"multilingual","Multilingual",[53,2200,2201],{},"One of my use cases was creating bilingual resumes that look the same. It quickly became a struggle because of the issues above, plus the sheer mix of tags, classes, and actual content. I could paste the HTML file into an LLM and ask it to translate, but:",[289,2203,2204,2207,2210],{},[70,2205,2206],{},"I should still review its output and make changes.",[70,2208,2209],{},"Encoded images will eat unnecessary tokens.",[70,2211,2212,2213,2229,2232],{},"Compare the Chinese and English versions of the same sentence:",[202,2214,2217],{"className":2215,"code":2216,"language":18,"meta":13,"style":13},"language-md shiki shiki-themes github-light github-dark","> London is the capital of the United Kingdom.\n> 伦敦是英国的首都。\n",[208,2218,2219,2224],{"__ignoreMap":13},[211,2220,2221],{"class":213,"line":214},[211,2222,2223],{"class":504},"> London is the capital of the United Kingdom.\n",[211,2225,2226],{"class":213,"line":14},[211,2227,2228],{"class":504},"> 伦敦是英国的首都。\n",[2230,2231],"br",{},"It's obvious that the Chinese version is shorter than the English one. If you simply translate the same HTML template, the fixed-size boxes and page breaks would drift. For example, a two-page Chinese resume can become a three- or four-page English resume, which may be considered oversized. So I'd also need to adjust styles and template structure. Remember the work experience list example? Be frightened!",[48,2234,2236],{"id":2235},"solution","Solution",[53,2238,2239],{},"Stop using HTML for your resume. Or not?",[53,2241,2242],{},"When I ran into these issues, I started thinking about how to keep the benefits of HTML while removing the problems. And I found a really nice solution.",[90,2244,2246],{"id":2245},"concept","Concept",[53,2248,2249,2250,104],{},"We need to understand the actual core problem. Let's go back to our requirements — one of them was ",[135,2251,2096],{},[53,2253,2254,2255,2258,2259,2262,2263,2266],{},"CV.html has three tabs: ",[135,2256,2257],{},"Template",", where the user writes HTML; ",[135,2260,2261],{},"Styles",", where the user writes CSS; and ",[135,2264,2265],{},"Head",", for additional external imports (Tailwind CSS, fonts, etc.). While separation technically exists between content and style via the Template and Styles tabs, the actual experience was the opposite.",[53,2268,2269,2270,104],{},"That's because this point needs to be formulated a bit differently: ",[135,2271,2272,2273,2276],{},"separation of content, ",[1722,2274,2275],{},"template",", and style",[53,2278,2279,2280,150,2283,2285],{},"We need to decompose HTML into ",[135,2281,2282],{},"content",[135,2284,2275],{}," parts first. Let's define them:",[67,2287,2288,2298],{},[70,2289,2290,2293,2294,2297],{},[135,2291,2292],{},"Content"," — all the ",[1722,2295,2296],{},"information"," in the resume: text, images, and any other metadata the template needs.",[70,2299,2300,2302,2303,2306,2307,2310,2311,150,2313,2316],{},[135,2301,2257],{}," — the ",[1722,2304,2305],{},"structure"," of the resume. It can also be described as the ",[1722,2308,2309],{},"compilation"," of ",[135,2312,2282],{},[135,2314,2315],{},"styles"," according to the user's rules.",[90,2318,2320],{"id":2319},"implementation","Implementation",[2322,2323,2257],"h4",{"id":2275},[53,2325,2326,2327,2329,2330,2333],{},"The main focus should be the ",[135,2328,2257],{}," section. Those HTML issues aren't new — frontend ",[1722,2331,2332],{},"frameworks"," already solved them. But creating a React app for a resume would be overengineering: it would be heavy, the user wouldn't need most of the features, it would complicate PDF export, and it would make raw HTML export unavailable. For comfortable work, we need only the following framework's features:",[289,2335,2336,2339,2345],{},[70,2337,2338],{},"Loop and conditional rendering to remove bloat.",[70,2340,2341,2342,2344],{},"Binding to dynamic variables, with ",[135,2343,2282],{}," stored separately.",[70,2346,2347],{},"Static HTML as the final output.",[53,2349,2350],{},"This isn't a common use case, but it's a valid one — and the perfect tool already exists.",[53,2352,2353,2354,2359],{},"Welcome, ",[98,2355,2358],{"href":2356,"rel":2357},"https:\u002F\u002Fhandlebarsjs.com",[102],"Handlebars","!",[53,2361,2362,2363,2365,2366,2371],{},"In short, ",[135,2364,2358],{}," is a simple templating language that takes a template and an input object to generate HTML or other text formats. You can read more about its features in the ",[98,2367,2370],{"href":2368,"rel":2369},"https:\u002F\u002Fhandlebarsjs.com\u002Fguide",[102],"docs",", but I'll focus only on what's important for us:",[289,2373,2374,2388,2396],{},[70,2375,2376,2377,150,2382,2387],{},"Has ",[98,2378,2381],{"href":2379,"rel":2380},"https:\u002F\u002Fhandlebarsjs.com\u002Fguide\u002Fbuiltin-helpers.html#each",[102],"loop",[98,2383,2386],{"href":2384,"rel":2385},"https:\u002F\u002Fhandlebarsjs.com\u002Fguide\u002Fbuiltin-helpers.html#if",[102],"conditional"," rendering out of the box.",[70,2389,2376,2390,2395],{},[98,2391,2394],{"href":2392,"rel":2393},"https:\u002F\u002Fhandlebarsjs.com\u002Fguide\u002Fexpressions.html#basic-usage",[102],"bindings"," to object variables.",[70,2397,2398],{},"Can be compiled at runtime to HTML.",[53,2400,2401],{},"Additionally, its syntax is very similar to modern frontend frameworks, so it's easy for my fellow frontend devs to pick up.",[2322,2403,2292],{"id":2282},[53,2405,2406,2407,2409,2410,2413],{},"The easy part is extracting ",[135,2408,2282],{}," from HTML into a JS object. We can create a JSON or YAML file where the user defines their ",[208,2411,2412],{},"cv"," — all text data, attributes like a base64 image string, and so on — and then parse it.",[53,2415,2416],{},"Then we pass this object to Handlebars and let the user access it in the template. I chose YAML because it's more human-readable than JSON.",[90,2418,2420],{"id":2419},"result","Result",[53,2422,2423],{},"I've already implemented this solution, tested it, and it works really well — with massive flexibility. Here's how that looks in practice:",[53,2425,2426,2427,104],{},"Maybe you want a bilingual resume? Or even the same template for another person? That can be done just by replacing the ",[135,2428,2282],{},[2430,2431,2437,2438,2437,2444,2437,2449,2454],"div",{"className":2432},[2433,2434,2435,2436],"flex","gap-2","md:flex-row","flex-col","\n    ",[1818,2439],{"src":2440,"width":1821,"height":2441,"sizes":2442,"alt":2443,"caption":2443},"\u002Fimages\u002Fcvhtml-original.png",1975,"(min-width: 768px) calc((min(100vw, 40rem) - 4.25rem) \u002F 3), min(calc(100vw - 2.75rem), calc(40rem - 2.75rem))","Original CV.html resume",[1818,2445],{"src":2446,"width":1821,"height":2447,"sizes":2442,"alt":2448,"caption":2448},"\u002Fimages\u002Fcvhtml-russian.png",1868,"Same resume translated in Russian",[1818,2450],{"src":2451,"width":1821,"height":2452,"sizes":2442,"alt":2453,"caption":2453},"\u002Fimages\u002Fcvhtml-johndoe.png",1541,"Same template for random user","\n  ",[53,2456,2457,2458,104],{},"Or maybe you want another design? No worries — just replace the ",[135,2459,2275],{},[2430,2461,2437,2463,2437,2468,2437,2473,2454],{"className":2462},[2433,2434,2435,2436],[1818,2464],{"src":2465,"width":1821,"height":2466,"sizes":2442,"alt":2467,"caption":2467},"\u002Fimages\u002Fcvhtml-pinkycute.png",2006,"Pinky-cute template",[1818,2469],{"src":2470,"width":1821,"height":2471,"sizes":2442,"alt":2472,"caption":2472},"\u002Fimages\u002Fcvhtml-newspaper.png",2143,"Newspaper template",[1818,2474],{"src":2475,"width":1821,"height":2476,"sizes":2442,"alt":2477,"caption":2477},"\u002Fimages\u002Fcvhtml-terminal.png",2050,"Terminal template",[53,2479,2480,2481,104],{},"There's so much customization that I still find new usage ideas and designs. You can try it too at ",[2482,2483],"cv-html-badge",{"className":2484},[2485],"ml-1",[48,2487,1669],{"id":1668},[53,2489,2490,2491,2493,2494,150,2496,2499],{},"Is HTML still the best ",[1722,2492,2066],{}," format? Technically no — we replaced it with two independent ",[208,2495,491],{},[208,2497,2498],{},"hbs"," (Handlebars) files. But it still serves as an intermediate format between your source files and PDF, and you can still use the benefits of HTML like rendering it on a website.",[53,2501,2502,2503,2505,2506,2508],{},"So I would still say you should treat it as the output and author your resume in ",[135,2504,2282],{}," \u002F ",[135,2507,2275],{}," abstractions and while native HTML doesn't have such separation, the ecosystem has all the right tools to achieve it!",[1674,2510,2511],{},"html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .s9eBZ, html code.shiki .s9eBZ{--shiki-default:#22863A;--shiki-dark:#85E89D}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":13,"searchDepth":14,"depth":14,"links":2513},[2514,2515,2520,2525],{"id":61,"depth":14,"text":62},{"id":2122,"depth":14,"text":2123,"children":2516},[2517,2518,2519],{"id":2129,"depth":242,"text":2130},{"id":2154,"depth":242,"text":2155},{"id":2197,"depth":242,"text":2198},{"id":2235,"depth":14,"text":2236,"children":2521},[2522,2523,2524],{"id":2245,"depth":242,"text":2246},{"id":2319,"depth":242,"text":2320},{"id":2419,"depth":242,"text":2420},{"id":1668,"depth":14,"text":1669},"2026-06-13 00:00:00 UTC","Continuation of the resume topic and major improvements in CV.html","8 min",{},"\u002Fposts\u002Fstop-using-html-for-your-resume",{"title":2035,"description":2527},{"loc":2530,"lastmod":2526},"posts\u002Fstop-using-html-for-your-resume",[1701,2118],"AXpSO_qbRcB1C_q5fXrwUEmlCn50GHnVzdRTK27_9cs",{"id":2537,"title":2053,"body":2538,"date":3229,"description":3230,"duration":1694,"extension":18,"meta":3231,"navigation":20,"path":2052,"robots":16,"seo":3232,"sitemap":3233,"stem":3234,"tags":3235,"toc":20,"__hash__":3236},"content_en\u002Fposts\u002Fstop-using-word-for-your-resume.md",{"type":7,"value":2539,"toc":3214},[2540,2544,2547,2554,2557,2566,2577,2580,2585,2588,2591,2595,2601,2656,2660,2664,2674,2691,2694,2697,2728,2739,2742,2746,2749,2766,2769,2805,2808,2812,2815,2839,2842,2868,2879,2890,2894,2897,2899,2901,2908,2911,2915,2918,2960,2963,2971,2974,2978,2981,3116,3118,3122,3125,3128,3131,3137,3140,3179,3193,3200,3202,3205,3208,3211],[34,2541,2542],{"id":13},[37,2543],{"value":39},[41,2545],{":duration":43,":date":44,"className":2546},[46],[53,2548,2549,2550,2553],{},"Every professional needs a resume. It's the most impactful document you have — one that shapes the first ",[1722,2551,2552],{},"impression"," of you.",[53,2555,2556],{},"When I started working in IT, the easiest and most obvious option was to use job-search platforms. All popular hiring websites offer a form that, once completed, generates a downloadable document for any HR person or recruiter to review.",[53,2558,2559,2560,2563,2564,2148],{},"But what if you use ",[1722,2561,2562],{},"several"," hiring platforms? Maintaining them quickly becomes tedious. Sooner or later, a single edit to your resume turns into a series of repetitive updates across different websites. In developer terms, this violates the ",[135,2565,2147],{},[53,2567,2568,2569,2572,2573,2576],{},"One solution is to keep your resume in a single editable file, update it when needed, and then sync it with all the platforms. This doesn't ",[1722,2570,2571],{},"fully"," solve the problem — you still have to manually copy and paste content — but it creates a ",[135,2574,2575],{},"single source of truth"," from which all copies are derived. On top of that, resumes exported by these platforms tend to be ugly and uniform, making them indistinguishable from one another and easy to skip.",[53,2578,2579],{},"This led me to a simple question:",[106,2581,2582],{},[53,2583,2584],{},"Which format should I use to create and store my source resume?",[53,2586,2587],{},"I spent far more time on this than I expected — and even had to build a simple tool along the way (more on that later).",[2589,2590],"hr",{},[48,2592,2594],{"id":2593},"defining-the-requirements","Defining the Requirements",[53,2596,2597,2598,958],{},"Before comparing formats, I needed to define what I actually want. Here's my list, ordered by ",[135,2599,2600],{},"importance",[289,2602,2603,2612,2618,2624,2630,2635,2644,2650],{},[70,2604,2605,2608,2609,2611],{},[135,2606,2607],{},"Transformable to PDF"," — PDF is the universal format for sharing resumes, so the source format ",[135,2610,1998],{}," convert to it cleanly.",[70,2613,2614,2617],{},[135,2615,2616],{},"Precise layout control"," — margins, columns, spacing, and alignment should be easy to define and adjust.",[70,2619,2620,2623],{},[135,2621,2622],{},"Rich and flexible styling"," — fonts, colors, sizes, and visual hierarchy should be straightforward to apply.",[70,2625,2626,2629],{},[135,2627,2628],{},"Easy to author content"," — writing and editing text should feel natural, without fighting the format.",[70,2631,2632,2634],{},[135,2633,2076],{}," — LLMs can speed up creating, modifying, and reviewing resumes. ATS compatibility is less critical since the final output is PDF, but it's still nice if the raw format is parseable too.",[70,2636,2637,2640,2641,104],{},[135,2638,2639],{},"Version-controllable"," — the format should be text-based so changes can be tracked, ideally with ",[135,2642,2643],{},"Git",[70,2645,2646,2649],{},[135,2647,2648],{},"Portable"," — not locked into any specific tool, editor, or platform.",[70,2651,2652,2655],{},[135,2653,2654],{},"Separation of content and style"," — so you can redesign the look without rewriting the content.",[48,2657,2659],{"id":2658},"evaluating-the-options","Evaluating the Options",[90,2661,2663],{"id":2662},"microsoft-word-docx","Microsoft Word (.docx)",[53,2665,2666,2667,2669,2670,2673],{},"The most popular ",[1722,2668,2066],{}," resume format is without a doubt ",[135,2671,2672],{},".docx",". Its strengths:",[67,2675,2676,2681,2687],{},[70,2677,2678],{},[135,2679,2680],{},"Easy to transform to PDF",[70,2682,2683,2686],{},[135,2684,2685],{},"Rich styling"," — you can easily change fonts, colors, etc.",[70,2688,2689],{},[135,2690,2628],{},[53,2692,2693],{},"And... no, that's all.",[53,2695,2696],{},"Now the weaknesses:",[67,2698,2699,2705,2711,2717,2723],{},[70,2700,2701,2704],{},[135,2702,2703],{},"Layout control exists",", but IMHO it's clunky to work with.",[70,2706,2707,2710],{},[135,2708,2709],{},"Not LLM friendly at all"," due to binary encoding. You can't paste raw content into an LLM. LLMs can't generate .docx files. ATS is excellent though.",[70,2712,2713,2716],{},[135,2714,2715],{},"Not version-controllable"," — binary format means no meaningful diffs.",[70,2718,2719,2722],{},[135,2720,2721],{},"Not portable",". You're limited to Word (paid, desktop-only), Google Docs, or free editors that tend to be unstable.",[70,2724,2725,104],{},[135,2726,2727],{},"Separation of content and style is practically nonexistent",[53,2729,2730,2731,2734,2735,2738],{},"So the most popular resume format satisfies only ",[135,2732,2733],{},"3 out of 8"," requirements. The same applies to ",[135,2736,2737],{},".gdoc",", which is essentially Google's equivalent.",[53,2740,2741],{},"My main frustration is the dependency on third-party products and the limited, hard-to-modify layout. Definitely not for me.",[90,2743,2745],{"id":2744},"latex-tex","LaTeX (.tex)",[53,2747,2748],{},"The format for math nerds. Its strengths:",[67,2750,2751,2756,2761],{},[70,2752,2753,104],{},[135,2754,2755],{},"Extremely high-quality PDF output",[70,2757,2758,104],{},[135,2759,2760],{},"Precise control over spacing and layout",[70,2762,2763,2765],{},[135,2764,2628],{}," (once you learn the syntax).",[53,2767,2768],{},"On the other hand:",[67,2770,2771,2781,2788,2794,2800],{},[70,2772,2773,2774,2777,2778,104],{},"Styling is powerful but ",[135,2775,2776],{},"verbose and hard to customize"," — most of the LaTeX resumes look familiarly ",[1722,2779,2780],{},"scientific",[70,2782,2783,2784,2787],{},"While .tex files are technically plain text, the verbose syntax makes them ",[135,2785,2786],{},"harder to work with for LLMs and ATS"," than simpler formats.",[70,2789,2790,2793],{},[135,2791,2792],{},"Version control is possible",", but the noisy syntax makes diffs harder to read.",[70,2795,2796,2799],{},[135,2797,2798],{},"More portable than .docx",", but you still need a TeX distribution or a dedicated editor.",[70,2801,2802,104],{},[135,2803,2804],{},"No real separation of content and style",[53,2806,2807],{},"LaTeX is better than .docx, but still doesn't check enough boxes. Not for me.",[90,2809,2811],{"id":2810},"markdown-md","Markdown (.md)",[53,2813,2814],{},"Here's where things get interesting. Strengths:",[67,2816,2817,2822,2827,2833],{},[70,2818,2819,104],{},[135,2820,2821],{},"Really easy to author content",[70,2823,2824,104],{},[135,2825,2826],{},"Fully LLM and ATS friendly",[70,2828,2829,2832],{},[135,2830,2831],{},"Version control is effortless"," (especially with Git).",[70,2834,2835,2838],{},[135,2836,2837],{},"Extremely portable"," — any text editor will do.",[53,2840,2841],{},"Much better! But there are notable gaps:",[67,2843,2844,2850,2856,2862],{},[70,2845,2846,2849],{},[135,2847,2848],{},"No layout control"," — only document structure.",[70,2851,2852,2855],{},[135,2853,2854],{},"No styling"," — it's plain text content.",[70,2857,2858,2861],{},[135,2859,2860],{},"Nothing to separate"," when there are no styles.",[70,2863,2864,2867],{},[135,2865,2866],{},"PDF export is possible"," but not straightforward.",[53,2869,2870,2871,2874,2875,2878],{},"The core problem is that Markdown is ",[135,2872,2873],{},"headless"," — it requires a custom ",[135,2876,2877],{},"toolchain"," to transform content into a final, styled PDF. That said, most of these tools are open source.",[53,2880,2881,2882,2885,2886,2889],{},"So you ",[1722,2883,2884],{},"can"," freely edit your resume's content, but ",[1722,2887,2888],{},"can't"," control its appearance out of the box. A clear step up, but let's see what else is out there.",[90,2891,2893],{"id":2892},"json-yaml-structured-resume","JSON \u002F YAML Structured Resume",[53,2895,2896],{},"I won't spend much time on this — it's essentially the same story as Markdown, with even less styling support.",[2589,2898],{},[48,2900,2236],{"id":2235},[53,2902,2903,2904,2907],{},"Those are the most common formats people use for resumes, and none of them truly fit my needs. What I wanted was full control over content, styles, ",[1722,2905,2906],{},"and"," layout. If only there were a markup language that separates structure and styling, supports precise layout, and exports cleanly to PDF...",[53,2909,2910],{},"WAIT... and then it clicked!",[90,2912,2914],{"id":2913},"hypertext-markup-language-html","HyperText Markup Language (HTML)",[53,2916,2917],{},"Straight to the point:",[67,2919,2920,2926,2932,2942,2948,2954],{},[70,2921,2922,2925],{},[135,2923,2924],{},"Easily transformed to PDF"," via browser print or automation tools.",[70,2927,2928,2931],{},[135,2929,2930],{},"Layout control is excellent"," — Flexbox, Grid, you name it.",[70,2933,2934,2937,2938,2941],{},[135,2935,2936],{},"Rich"," — no, ",[135,2939,2940],{},"RICH"," styling with the full power of CSS, including hovers and animations (though not in PDF).",[70,2943,2944,2947],{},[135,2945,2946],{},"Fully LLM friendly"," — you can easily generate and modify styled resumes. ATS can often parse it as well, though overly complex markup may cause issues..",[70,2949,2950,2953],{},[135,2951,2952],{},"Version control"," is just as easy as Markdown — it's plain text.",[70,2955,2956,2959],{},[135,2957,2958],{},"Fully portable"," — both content and layout travel with the file.",[53,2961,2962],{},"Any downsides? Of course:",[67,2964,2965],{},[70,2966,2967,2970],{},[135,2968,2969],{},"Content mixes with markup"," — tags and styles live alongside your text. It's still readable, but separation isn't ideal.",[53,2972,2973],{},"And... yes, that's it for the obvious ones!",[90,2975,2977],{"id":2976},"hidden-gotchas","Hidden Gotchas",[53,2979,2980],{},"Having worked with HTML resumes for a while, I've encountered a few less obvious issues:",[67,2982,2983,2989,3018],{},[70,2984,2985,2988],{},[135,2986,2987],{},"You need to know HTML and CSS"," to write it. That said, LLMs can generate it for you.",[70,2990,2991,2994,2995,2997,2998,3015,3017],{},[135,2992,2993],{},"Browser rendering differs across operating systems."," The same HTML can look different on Windows vs. macOS.",[2230,2996],{},"Take a look at these two renderings of the same HTML resume on different systems:",[2430,2999,2454,3001,2454,3008],{"className":3000},[2433,2434,2435,2436],[1818,3002],{"src":3003,"width":1821,"height":3004,"sizes":3005,"alt":3006,"caption":3007},"\u002Fimages\u002Fresume-macos.png",2097,"(min-width: 768px) calc((min(100vw, 40rem) - 3.5rem) \u002F 2), min(calc(100vw - 2.75rem), calc(40rem - 2.75rem))","HTML resume on macos","HTML on macOS",[1818,3009],{"src":3010,"width":3011,"height":3012,"sizes":3005,"alt":3013,"caption":3014},"\u002Fimages\u002Fresume-windows.png",800,1155,"HTML resume on windows","Same HTML on Windows",[2230,3016],{},"The font appears different even though the CSS properties are identical. I spent a long time researching this, and unfortunately it can't be fully fixed. The good news is that once rendered to PDF, the result looks the same everywhere.",[70,3019,3020,3023,3024,3026,3027,3113,3115],{},[135,3021,3022],{},"No built-in page breaks."," You have to handle pagination manually.",[2230,3025],{},"CSS helps with properties like:",[202,3028,3030],{"className":1514,"code":3029,"language":1516,"meta":13,"style":13},".page {\n  width: 210mm;\n  height: 297mm;\n}\n\n@media print {\n  .page {\n    break-after: page;\n  }\n}\n",[208,3031,3032,3039,3054,3068,3072,3076,3086,3093,3105,3109],{"__ignoreMap":13},[211,3033,3034,3037],{"class":213,"line":214},[211,3035,3036],{"class":344},".page",[211,3038,949],{"class":217},[211,3040,3041,3044,3046,3049,3052],{"class":213,"line":14},[211,3042,3043],{"class":223},"  width",[211,3045,508],{"class":217},[211,3047,3048],{"class":223},"210",[211,3050,3051],{"class":824},"mm",[211,3053,1557],{"class":217},[211,3055,3056,3059,3061,3064,3066],{"class":213,"line":242},[211,3057,3058],{"class":223},"  height",[211,3060,508],{"class":217},[211,3062,3063],{"class":223},"297",[211,3065,3051],{"class":824},[211,3067,1557],{"class":217},[211,3069,3070],{"class":213,"line":256},[211,3071,259],{"class":217},[211,3073,3074],{"class":213,"line":532},[211,3075,839],{"emptyLinePlaceholder":20},[211,3077,3078,3081,3084],{"class":213,"line":543},[211,3079,3080],{"class":824},"@media",[211,3082,3083],{"class":223}," print",[211,3085,949],{"class":217},[211,3087,3088,3091],{"class":213,"line":551},[211,3089,3090],{"class":344},"  .page",[211,3092,949],{"class":217},[211,3094,3095,3098,3100,3103],{"class":213,"line":559},[211,3096,3097],{"class":223},"    break-after",[211,3099,508],{"class":217},[211,3101,3102],{"class":223},"page",[211,3104,1557],{"class":217},[211,3106,3107],{"class":213,"line":567},[211,3108,1368],{"class":217},[211,3110,3111],{"class":213,"line":578},[211,3112,259],{"class":217},[2230,3114],{},"These lock the dimensions to a real printable page. But combined with the cross-OS rendering differences, page breaks can shift when editing on different devices — an annoying source of inconsistency.",[2589,3117],{},[48,3119,3121],{"id":3120},"building-the-tool","Building the Tool",[53,3123,3124],{},"When I settled on HTML, I started looking for a dedicated tool. Surely I wasn't the first person to think of this use case.",[53,3126,3127],{},"But nothing quite fit. I couldn't find a tool that gave you direct, full control over an HTML resume. The closest options were form-based builders where you load data and pick a template — but they weren't free, and they didn't give you a raw editable file.",[53,3129,3130],{},"The other obvious approach was editing HTML directly in VS Code, but constantly switching to a browser is tedious. Page breaks are only visible in print preview, and you have to manually export every time.",[53,3132,3133,3134,104],{},"So I decided to build the tool myself. I called it ",[2482,3135],{"className":3136},[2485],[53,3138,3139],{},"It's a Monaco Editor with a live preview, packed with features like:",[67,3141,3142,3147,3153,3159,3164,3174],{},[70,3143,3144],{},[135,3145,3146],{},"Export to PDF",[70,3148,3149,3152],{},[135,3150,3151],{},"Import \u002F Export HTML"," — save, load, and modify your resume freely",[70,3154,3155,3158],{},[135,3156,3157],{},"TailwindCSS support"," (yeah, really!)",[70,3160,3161],{},[135,3162,3163],{},"Auto-formatting with Prettier",[70,3165,3166,3169,3170,3173],{},[135,3167,3168],{},"Handy extras"," like A4 page outline, utility styles, customizable ",[208,3171,3172],{},"\u003Chead>"," for fonts, and more",[70,3175,3176],{},[135,3177,3178],{},"Completely free and open source",[53,3180,3181,3182,3186,3187,3192],{},"If you've read this far and are interested, check it out ",[98,3183,3185],{"href":2116,"rel":3184},[102],"hosted"," or on ",[98,3188,3191],{"href":3189,"rel":3190},"https:\u002F\u002Fgithub.com\u002Frastuhacode\u002Fcv.html",[102],"GitHub",". I'd be glad if you find it useful and appreciate any feedback!",[53,3194,3195,3196,3199],{},"There's still plenty of room for improvement. For instance, text replacement isn't straightforward because ",[208,3197,3198],{},"\u003Cspan>"," tags and other markup get mixed with content. I plan to decompose the template and data layers in a future.",[48,3201,1669],{"id":1668},[53,3203,3204],{},"Many developers keep their resume in Markdown, LaTeX, or .docx, but HTML offers a surprisingly powerful alternative.",[53,3206,3207],{},"It's not perfect, but for my needs it turned out to be the best option — offering unmatched control over content, styling, and layout in a portable, version-controllable format.",[53,3209,3210],{},"I hope you found this article helpful. See you next time!",[1674,3212,3213],{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":13,"searchDepth":14,"depth":14,"links":3215},[3216,3217,3223,3227,3228],{"id":2593,"depth":14,"text":2594},{"id":2658,"depth":14,"text":2659,"children":3218},[3219,3220,3221,3222],{"id":2662,"depth":242,"text":2663},{"id":2744,"depth":242,"text":2745},{"id":2810,"depth":242,"text":2811},{"id":2892,"depth":242,"text":2893},{"id":2235,"depth":14,"text":2236,"children":3224},[3225,3226],{"id":2913,"depth":242,"text":2914},{"id":2976,"depth":242,"text":2977},{"id":3120,"depth":14,"text":3121},{"id":1668,"depth":14,"text":1669},"2026-03-20 00:00:00 UTC","A practical comparison of resume formats",{},{"title":2053,"description":3230},{"loc":2052,"lastmod":3229},"posts\u002Fstop-using-word-for-your-resume",[1701,2118],"lOVo9wVj5NXnuCpvtFZy6V6Dz4ZJZCicIHtFmsItzww",{"id":3238,"title":3239,"body":3240,"date":3731,"description":3732,"duration":2528,"extension":18,"meta":3733,"navigation":20,"path":3734,"robots":16,"seo":3735,"sitemap":3736,"stem":3737,"tags":3738,"toc":20,"__hash__":3741},"content_en\u002Fposts\u002Fwhy-i-cant-use-music-services.md","Why I don’t use music streaming services",{"type":7,"value":3241,"toc":3717},[3242,3246,3249,3251,3254,3257,3261,3270,3276,3279,3286,3290,3297,3304,3310,3314,3321,3324,3332,3335,3339,3342,3345,3351,3355,3361,3364,3434,3437,3466,3473,3477,3483,3492,3501,3505,3508,3517,3524,3533,3535,3538,3541,3561,3563,3566,3569,3575,3586,3590,3597,3639,3645,3672,3675,3704,3707,3711,3714],[34,3243,3244],{"id":13},[37,3245],{"value":39},[41,3247],{":duration":43,":date":44,"className":3248},[46],[48,3250,62],{"id":61},[53,3252,3253],{},"This is probably the most personal post I've written so far, as these thoughts have followed me for about four years. With both the world and my life constantly changing, I struggled to come up with the right solution.",[53,3255,3256],{},"Recently, I've had a bit more time and enthusiasm to tackle this issue. So, with a plan based on my theories and some help from agents, I started experimenting.",[48,3258,3260],{"id":3259},"beginning","Beginning",[53,3262,3263,3264,3269],{},"Music has been my passion since I was about 14. In terms of its impact on my life, it could be considered equal even to programming. I didn't just listen to music, but I also ",[98,3265,3268],{"href":3266,"rel":3267},"https:\u002F\u002Fsoundcloud.com\u002Frastuharem",[102],"wrote"," my own. I never had any money in mind and just wrote it as a hobby - I enjoyed it so much.",[53,3271,3272,3273,104],{},"I've since taken a break from writing music, but I still listen to it a lot. And throughout that time, one thing has remained clear to me: ",[135,3274,3275],{},"all music streaming services suck",[53,3277,3278],{},"I completely understand why most people don't have an issue with them, although I would still recommend reconsidering how you use them.",[53,3280,3281,3282,3285],{},"I'll try to explain ",[135,3283,3284],{},"my"," issues, how they emerged over time, and how I became convinced of this opinion.",[48,3287,3289],{"id":3288},"history","History",[53,3291,3292,3293,3296],{},"If you listen to music, I have a genuine question for you: ",[135,3294,3295],{},"what is music to you?"," Why do you listen to it? Maybe you like deep lyrics, the bounce of EDM, distorted rock guitars, or the flow of an orchestra.",[53,3298,3299,3300,3303],{},"I like all of that, but my main reason is that ",[135,3301,3302],{},"music is a storage medium for memories",". A song can hold a life-changing event, a prolonged period of your life, a clutch in a game, or a connection to another work of art—an anime opening or a film's closing credits. My music collection contains all those moments, combined and shuffled, ready to bring those memories back.",[53,3305,3306,3307,104],{},"That's why I think of my collection as a treasure. I want to keep it forever and always be able to both \"write\" and \"read\" memories from it. I want it to be available on a plane, train, or in a car; while I'm gaming, working, or writing this post. My music should ",[135,3308,3309],{},"always be accessible",[90,3311,3313],{"id":3312},"everywhere","Everywhere",[53,3315,3316,3317,3320],{},"This was the first core issue I identified: ",[135,3318,3319],{},"music services don't let you access your collection everywhere",". Of course, this wasn't entirely the services' fault; it was also a technical limitation.",[53,3322,3323],{},"With that in mind, I created the following system:",[289,3325,3326,3329],{},[70,3327,3328],{},"Buy songs and store them locally on my phone's SD card. This would give me a source of truth and reliable access.",[70,3330,3331],{},"Log in to a music service and manually sync it with my local library. This was for convenience: I could listen while gaming on my PC or working on my laptop without connecting my phone, transferring files, or moving the SD card every time. At the time, I used VK Music for this. Keep in mind that Spotify wasn't available in Russia, and VK was actually the best option—we'll return to it later.",[53,3333,3334],{},"Although music services let you cache tracks for offline listening, this is usually a paid and restricted feature that I didn't want to rely on.",[90,3336,3338],{"id":3337},"anything","Anything",[53,3340,3341],{},"When I started creating music, I wanted to upload my own tracks as part of that \"sync.\" Fortunately, VK allowed me to do so. In the meantime, Spotify officially launched in Russia, so I wanted to try it.",[53,3343,3344],{},"It was a huge disappointment to discover that Spotify did not let me upload a track directly into a cloud-synced personal library; officially releasing it required a distributor. In addition, some of the artists I listened to were self-releasing and didn't have a Spotify profile, so part of my collection was simply missing.",[53,3346,3347,3348,104],{},"The second issue emerged: ",[135,3349,3350],{},"music services don't let you listen to anything you want",[90,3352,3354],{"id":3353},"inconsistency","Inconsistency",[53,3356,3357,3358,104],{},"My breaking point was the third issue I recognized over time: ",[135,3359,3360],{},"music services are context-dependent",[53,3362,3363],{},"Unfortunately, I encountered several different examples:",[67,3365,3366,3388,3418],{},[70,3367,3368,3369,3374,3375,3380,3381,3384,3385,104],{},"In April 2022, Spotify ",[98,3370,3373],{"href":3371,"rel":3372},"https:\u002F\u002Fnewsroom.spotify.com\u002F2022-03-02\u002Fspotifys-statement-in-response-to-the-war-in-ukraine\u002F",[102],"left"," the Russian market after being ",[98,3376,3379],{"href":3377,"rel":3378},"https:\u002F\u002Fnewsroom.spotify.com\u002F2020-07-14\u002Fspotify-is-now-available-in-russia-croatia-ukraine-and-10-other-european-markets\u002F",[102],"available"," for ",[135,3382,3383],{},"less than two years",". People who used the platform effectively ",[135,3386,3387],{},"lost access to their music collections",[70,3389,3390,3391,3396,3397,3405,3406,3414,3415,104],{},"VK was ",[98,3392,3395],{"href":3393,"rel":3394},"https:\u002F\u002Farchive.nytimes.com\u002Fdealbook.nytimes.com\u002F2014\u002F09\u002F16\u002Fmail-ru-takes-full-ownership-of-vkontakte-russias-largest-social-network\u002F?eafs_enabled=false",[102],"\"bought\""," by Mail.ru, which made poor business and technical decisions and lost a huge portion of its users. The music service was fine until a redesign ",[135,3398,3399,3404],{},[98,3400,3403],{"href":3401,"rel":3402},"https:\u002F\u002Fvc.ru\u002Fservices\u002F1722129-v-chem-problema-novogo-dizaina-vkontakte-s-tochki-zreniya-artistov-i-teh-kto-na-nih-podpisan",[102],"broke"," feed playback",". Then it started ",[135,3407,3408,3413],{},[98,3409,3412],{"href":3410,"rel":3411},"https:\u002F\u002Fwww.themoscowtimes.com\u002F2026\u002F04\u002F15\u002Frussian-websites-begin-blocking-vpn-users-as-internet-controls-tighten-a92511",[102],"blocking"," people using VPNs",", which many Russians rely on, making the ",[135,3416,3417],{},"app almost unusable",[70,3419,3420,3421,3426,3427,104],{},"More recently, new Russian censorship laws prompted labels and platforms to ",[98,3422,3425],{"href":3423,"rel":3424},"https:\u002F\u002Fwww.themoscowtimes.com\u002F2026\u002F03\u002F16\u002Frussias-censorship-laws-are-killing-its-pop-culture-a92220\u002Fpdf",[102],"edit or remove"," many songs. In many cases, this has meant ",[135,3428,3429,3430,3433],{},"replacing original tracks with ",[1722,3431,3432],{},"new"," versions",[53,3435,3436],{},"If you think this is all specific to Russia, consider this examples:",[67,3438,3439,3448,3457],{},[70,3440,3441,3442,3447],{},"India. In May 2025, its government advised streaming platforms to remove media originating in Pakistan on national-security grounds. Pakistani music subsequently ",[98,3443,3446],{"href":3444,"rel":3445},"https:\u002F\u002Fwww.indiatoday.in\u002Famp\u002Fentertainment\u002Fmusic\u002Fstory\u002Fpakistani-songs-pulled-down-from-spotify-after-indian-government-advisory-2725114-2025-05-15",[102],"disappeared"," from services including Spotify and Apple Music for Indian listeners. Once again, tracks people had saved were made unavailable because the political context around their library had changed.",[70,3449,3450,3451,3456],{},"Hong Kong, a 2024 court injunction targeting the protest anthem “Glory to Hong Kong” led YouTube to ",[98,3452,3455],{"href":3453,"rel":3454},"https:\u002F\u002Fapnews.com\u002Farticle\u002Fprotest-song-glory-to-hong-kong-remove-cbe6d6b24c3a80b1c0dc089b0a57223f",[102],"block dozens of videos locally",". Its distributor then removed the song from streaming platforms, including Apple Music and Spotify, with some removals extending beyond Hong Kong.",[70,3458,3459,3460,3465],{},"Turkey, a court ordered Spotify, Apple Music, and YouTube to ",[98,3461,3464],{"href":3462,"rel":3463},"https:\u002F\u002Fwww.balcanicaucaso.org\u002Fen\u002Fcp_article\u002Fmabel-matiz-music-and-censorship-in-turkey\u002F",[102],"block access"," to Mabel Matiz’s song “Perperişan” in 2025 after the Ministry of Family and Social Services argued that its lyrics threatened public order and family values.",[53,3467,3468,3469,3472],{},"Russia may be a thousand steps ahead of the rest of the world in this regard, but ",[135,3470,3471],{},"you are still not protected from radical interventions"," in your library. A music service can ban you, replace tracks in your library, suddenly put features behind a paywall, or simply become unusable to you.",[90,3474,3476],{"id":3475},"ui","UI",[53,3478,3479,3480,104],{},"While testing and using different streaming products, I also found that most ",[135,3481,3482],{},"music services have bad interfaces or lack essential features",[53,3484,3485,3486,3491],{},"I've already mentioned VK's redesign. I would also point to the awful Yandex Music ",[98,3487,3490],{"href":3488,"rel":3489},"https:\u002F\u002Ft-j.ru\u002Fnew-wave-4-u\u002F",[102],"redesign"," of \"My Wave\".",[53,3493,3494,3495,3500],{},"What about international music services? I was surprised to discover that most of them ",[98,3496,3499],{"href":3497,"rel":3498},"https:\u002F\u002Fwww.reddit.com\u002Fr\u002Ftruespotify\u002Fcomments\u002F1fy67cl\u002Fhow_to_add_multiple_songs_from_one_massive\u002F",[102],"don't offer bulk operations"," for tracks. You also can't clear your music preferences.",[48,3502,3504],{"id":3503},"changes","Changes",[53,3506,3507],{},"As these issues piled up, I kept searching for an acceptable solution. I researched almost every possibility, from self-hosting on a Raspberry Pi and using Plex to buying a separate player, but nothing seemed convenient enough.",[53,3509,3510,3511,3516],{},"In the meantime, Telegram ",[98,3512,3515],{"href":3513,"rel":3514},"https:\u002F\u002Ftelegram.org\u002Fblog\u002Fprofile-music-gift-themes",[102],"released"," Profile Music, which behaves similarly to VK's \"My Music.\" I started moving my online collection there, and it was good enough. My main issues were its primitive and inconvenient interface and the Telegram team's apparent lack of interest in adding essential features such as playlists (yes, there are no custom playlists), a separate window for tracks, bulk editing, and so on.",[53,3518,3519,3520,3523],{},"To be honest, comparing these issues with those of other music services is like comparing candy with tree bark. It might not be my ",[1722,3521,3522],{},"favorite"," candy, but I would choose it over bark every time.",[53,3525,3526,3527,3532],{},"A little later, after Telegram was ",[98,3528,3531],{"href":3529,"rel":3530},"https:\u002F\u002Fedition.cnn.com\u002F2026\u002F02\u002F10\u002Feurope\u002Ftelegram-ban-russia-web-block-latam-intl",[102],"blocked"," in Russia, I conveniently learned that an MTProto API exists, allowing anyone to create their own Telegram client.",[48,3534,2236],{"id":2235},[53,3536,3537],{},"I began wondering whether I could build a client specifically for music and implement the missing features, combining the best of both worlds: Telegram Desktop's broad availability and local-first playback with the good interfaces and features of music services.",[53,3539,3540],{},"I started researching and building. I wanted a desktop app primarily for macOS and Windows, with the possibility of expanding to Android in the future. I also preferred to write it in TypeScript simply because I was familiar with it, which would speed up development.",[53,3542,3543,3544,3549,3550,3555,3556,104],{},"I already had experience with ",[98,3545,3548],{"href":3546,"rel":3547},"https:\u002F\u002Fwww.electronjs.org\u002F",[102],"Electron",", but it couldn't be compiled for Android. ",[98,3551,3554],{"href":3552,"rel":3553},"https:\u002F\u002Fexpo.dev\u002F",[102],"Expo",", on the other hand, had no desktop versions and used React Native, which I hadn't worked with before. Eventually, I found a framework that fit my requirements better than any other: ",[98,3557,3560],{"href":3558,"rel":3559},"https:\u002F\u002Ftauri.app\u002F",[102],"Tauri",[2589,3562],{},[53,3564,3565],{},"With help from an agent and the fragments of C++ knowledge I retained from university, I managed to learn Rust to a workable level. After that, I just kept building and building...",[53,3567,3568],{},"My idea was that a user would log in to the app with their Telegram account through direct MTProto authentication and gain access to their Saved Music, renamed \"All Tracks\" or \"Library\" in my app. I would then add all the missing playlist operations and polish the experience with features such as offline playback, caching, and downloading.",[53,3570,3571,3572],{},"The result is my biggest personal project yet. I'm proud to introduce ",[3573,3574],"soundgrammy-badge",{},[2430,3576,2437,3580],{"className":3577},[2433,2434,3578,3579],"justify-center","w-full",[1818,3581],{"src":3582,"width":3583,"height":3584,"alt":3585,"caption":3585},"\u002Fimages\u002Fsoundgrammy-interface.png",2390,1522,"SoundGrammy interface",[48,3587,3589],{"id":3588},"soundgrammy","SoundGrammy",[53,3591,3592,3593,3596],{},"So, ",[135,3594,3595],{},"what is SoundGrammy",", and what does it currently offer?",[67,3598,3599,3609,3615,3621,3627,3633],{},[70,3600,3601,3604,3605,3608],{},[135,3602,3603],{},"Playlist creation and standard operations"," such as deletion and editing, plus additional features including export (mainly for cross-device syncing for now), caching for offline listening in the app, and downloading, which also creates an ",[208,3606,3607],{},"m3u8"," file.",[70,3610,3611,3614],{},[135,3612,3613],{},"Queue display and management",": create playlists from the queue and modify it while listening by adding, removing, or reordering tracks.",[70,3616,3617,3620],{},[135,3618,3619],{},"Track and playlist filtering",", which works especially well with the next feature.",[70,3622,3623,3626],{},[135,3624,3625],{},"Bulk track operations!"," You can cache, download, or add multiple selected tracks to a playlist.",[70,3628,3629,3632],{},[135,3630,3631],{},"Listening statistics",", \"Likeness,\" and other metrics, plus \"Popular,\" \"Recent,\" and \"Liked\" playlists that you can hide.",[70,3634,3635,3638],{},[135,3636,3637],{},"All other essential features and nice enhancements",": different shuffles, MSE streaming, cache TTL and maximum-size settings, fullscreen mode (with artwork bounce), and much more!",[53,3640,3641,3642,958],{},"What ",[135,3643,3644],{},"SoundGrammy is not",[67,3646,3647,3653,3659,3665],{},[70,3648,3649,3652],{},[135,3650,3651],{},"It is not a music service"," built around recommendations: you won't find \"tracks you might like,\" Spotify's Smart Shuffle, or similar features. The app treats your saved tracks as your library and respects its boundaries.",[70,3654,3655,3658],{},[135,3656,3657],{},"It is not a replacement for Telegram clients",": you won't find chats or groups. The app only authenticates with Telegram and fetches your Saved Music. You also need the Telegram app to modify your Saved Music, or \"All Tracks\" in SoundGrammy. It is a companion, not a replacement.",[70,3660,3661,3664],{},[135,3662,3663],{},"It is not an official Telegram product",", and I am not affiliated with Telegram in any way. Although SoundGrammy uses MTProto, all its code is open source and its data is stored locally on your device. You should still be cautious about where you log in.",[70,3666,3667,3668,3671],{},"Although Tauri apps can be compiled for all major modern platforms, ",[135,3669,3670],{},"only macOS and Windows are currently supported",". I plan to add Android support, but that requires a compact version of the interface. iOS and Linux versions are not planned because I don't use those devices and can't test on them. However, you can always build the source yourself and test it, also contributions are welcome!",[53,3673,3674],{},"That said it solves all the issues I described:",[67,3676,3677,3691,3697],{},[70,3678,3679,3680,3682,3683,3686,3687,3690],{},"It is accessible ",[135,3681,3312],{},". You can ",[135,3684,3685],{},"cache and download"," playlists for local playthrough or you can ",[135,3688,3689],{},"stream"," it from Telegram.",[70,3692,3693,3694,3696],{},"You can listen ",[135,3695,3337],{},". Telegram lets users to upload any audiofiles and add them to profile.",[70,3698,3699,3700,3703],{},"It is as ",[135,3701,3702],{},"context-independent"," as it can be. Telegram is a stable base and it is most likely won't change it's policies.",[53,3705,3706],{},"I won't recommend that everyone try it, because I think something like Spotify is enough for most people. I created this app primarily for myself, but if my reasoning and the issues I've described resonate with you, you're welcome to try it!",[48,3708,3710],{"id":3709},"summary","Summary",[53,3712,3713],{},"SoundGrammy does not try to replace Spotify or compete with every music service. It solves a narrower problem: turning Telegram’s Saved Music into a practical, local-friendly library with playlists, bulk operations, offline playback, downloads, and listening statistics.",[53,3715,3716],{},"I originally built it for myself, but I am releasing it in case someone else recognizes the same problems. If you want recommendations or doesn't have constant music library, a conventional streaming service will probably serve you better. If you want more control over the music you have already chosen, SoundGrammy may be worth trying.",{"title":13,"searchDepth":14,"depth":14,"links":3718},[3719,3720,3721,3727,3728,3729,3730],{"id":61,"depth":14,"text":62},{"id":3259,"depth":14,"text":3260},{"id":3288,"depth":14,"text":3289,"children":3722},[3723,3724,3725,3726],{"id":3312,"depth":242,"text":3313},{"id":3337,"depth":242,"text":3338},{"id":3353,"depth":242,"text":3354},{"id":3475,"depth":242,"text":3476},{"id":3503,"depth":14,"text":3504},{"id":2235,"depth":14,"text":2236},{"id":3588,"depth":14,"text":3589},{"id":3709,"depth":14,"text":3710},"2026-08-14 00:00:00 UTC","My long-term issues with music streaming services and the solution I came up with",{},"\u002Fposts\u002Fwhy-i-cant-use-music-services",{"title":3239,"description":3732},{"loc":3734,"lastmod":3731},"posts\u002Fwhy-i-cant-use-music-services",[1701,3739,3740],"music","life","XKRJuB6JBr57n8kBF8Y3tQ5gDUDHmj4JZEyP41xP5Lw",{"id":3743,"title":3744,"body":3745,"date":3935,"description":3936,"duration":2026,"extension":18,"meta":3937,"navigation":20,"path":3934,"robots":16,"seo":3938,"sitemap":3939,"stem":3940,"tags":3941,"toc":25,"__hash__":3942},"content_en\u002Fposts\u002Fyou-should-start-contribute-to-open-source.md","You should start contribute to open-source",{"type":7,"value":3746},[3747,3751,3754,3761,3764,3783,3785,3789,3792,3795,3799,3805,3808,3834,3837,3841,3848,3851,3877,3880,3883,3887,3896,3913,3923,3925,3928],[34,3748,3749],{"id":13},[37,3750],{"value":39},[41,3752],{":duration":43,":date":44,"className":3753},[46],[53,3755,3756,3757,3760],{},"If you are good developer, but looking for an opportunity to grow professionaly, you ",[135,3758,3759],{},"should start contribute to open-source",". And the reason goes beyond benefiting the community — it's much more beneficial for you directly.",[53,3762,3763],{},"For a long time I was really interested in contributing, but I both underestimated the value I'd get from contributions and overestimated the complexity of the process. In this article I want to touch on both of these themes and maybe make you reconsider your perspective on OSS.",[53,3765,3766,3767,3772,3773,150,3778,2359],{},"I'm proud to tell you that since the beginning of 2026 I've already made 10+ contributions, and even landed in the top 30 contributors in ",[98,3768,3771],{"href":3769,"rel":3770},"https:\u002F\u002Freka-ui.com\u002F",[102],"Reka UI"," — the core library for ",[98,3774,3777],{"href":3775,"rel":3776},"https:\u002F\u002Fui.nuxt.com\u002F",[102],"NuxtUI",[98,3779,3782],{"href":3780,"rel":3781},"https:\u002F\u002Fwww.shadcn-vue.com\u002F",[102],"shadcn-vue",[2589,3784],{},[48,3786,3788],{"id":3787},"the-barrier","The barrier",[53,3790,3791],{},"For a long time, the idea of contributing felt out of reach. Maintainers are smart and professional — what could I possibly offer? On top of that — working full-time left only evenings, it's not common to contribute in Russia, so nobody around me had ever done it, and the process itself was a mystery. Should you just pick an open issue? Go through the whole project hunting for bugs?",[53,3793,3794],{},"I tried different approaches and found one that worked for me, so I want to share it with you.",[48,3796,3798],{"id":3797},"the-playbook","The playbook",[53,3800,3801,3802,104],{},"The key mindset shift was simple - yet hard to find: ",[135,3803,3804],{},"stop treating third-party bugs as your app's problem",[53,3806,3807],{},"Here's the workflow that made me understand how I could contribute:",[289,3809,3810,3816,3822,3828],{},[70,3811,3812,3815],{},[135,3813,3814],{},"Split bugs into levels."," When something breaks, ask: is this your code or a dependency? It seems obvious, but think about how often you wrote workarounds for your app when the bug actually came from third-party.",[70,3817,3818,3821],{},[135,3819,3820],{},"Dig into the source."," If the bug is from a third-party — open the source and trace it. Most bugs are easier to find than you'd expect.",[70,3823,3824,3827],{},[135,3825,3826],{},"Solve first, then ask."," Come up with a fix and THEN open an issue asking if you can submit a PR. This order was key for me — the fear of taking on responsibility and failing was real. Knowing I had already found a fix made it much easier to step up.",[70,3829,3830,3833],{},[135,3831,3832],{},"Protect your deadlines."," If you're worried about timelines at work (since you can't control when your PR gets merged) — create a workaround in your codebase anyway and add a TODO linking to the issue to track the upstream fix.",[53,3835,3836],{},"Your first contribution doesn't need to be massive. A missing translation, an unexported type, a docs typo — it's enough to get familiar with the workflow: forking, branching, opening PRs, responding to reviews, etc.",[48,3838,3840],{"id":3839},"the-benefits","The benefits",[53,3842,3843,3844,3847],{},"So why do I think that you ",[135,3845,3846],{},"should contribute","?",[53,3849,3850],{},"As I said before — contributing is one of the rare cases where I underestimated the value I actually got. Every contribution delivers value in three directions at once:",[289,3852,3853,3859,3865],{},[70,3854,3855,3858],{},[135,3856,3857],{},"Your product."," That bug you fixed upstream? It's now fixed for your project too — properly, not with a workaround. Your codebase gets cleaner, and you stop carrying technical debt that isn't yours.",[70,3860,3861,3864],{},[135,3862,3863],{},"The community."," Every fix, every improvement, every translation helps thousands of developers who depend on the same library. Your one PR might save hundreds of people from writing the same workaround you did.",[70,3866,3867,3870,3871,3876],{},[135,3868,3869],{},"Yourself."," You ",[98,3872,3875],{"href":3873,"rel":3874},"https:\u002F\u002Fmedium.com\u002F@mohitsingh3406\u002Fwhy-reading-code-is-more-important-than-writing-it-30c01a489375",[102],"read"," code written by experienced developers. You get reviews from people who think differently than your team. You learn to write code that strangers can understand, to communicate in PRs, to think about edge cases that don't exist in your own project.",[53,3878,3879],{},"On top of that, contributing can become a really good networking tool and source of job opportunities. Although the direct impact of contributions on your job offers is overrated — the network you can build through them is not.",[53,3881,3882],{},"All of these are exactly the traits that separate good developers from great ones. Think about any programmer you admire — chances are, they're an open-source contributor. I think that's not a coincidence — OSS contributions aren't a consequence of being great, but a cause.",[48,3884,3886],{"id":3885},"the-controversy","The controversy",[53,3888,3889,3890,3895],{},"There's also an opposite position, which is well explained here: ",[98,3891,3894],{"href":3892,"rel":3893},"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=5nY_cy8zcO4",[102],"Don't Contribute to Open Source",". You may notice that my article title is the straight opposite of that video — and that was deliberate. That kind of position was actually gatekeeping me from trying to contribute and grow professionally.",[53,3897,3898,3899,3902,3903,3908,3909,3912],{},"While I mostly don't agree with this position, I still ",[135,3900,3901],{},"highly"," recommend watching it, as I totally agree that situations like ",[98,3904,3907],{"href":3905,"rel":3906},"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=YFkeOBqfQBw",[102],"Node.js README spam"," ",[135,3910,3911],{},"SHOULD NOT"," happen. I also understand the reason for gatekeeping, but I think it should be balanced and not too aggressive.",[53,3914,3915,3916,3919,3920,104],{},"But let me make it clear — while you ",[135,3917,3918],{},"should start contribute to open source",", you also ",[135,3921,3922],{},"must be respectful and responsible for your actions",[48,3924,1669],{"id":1668},[53,3926,3927],{},"If you've been thinking about contributing to open source but haven't started yet — you definitely should try. It could become both a growth opportunity and a rewarding experience. As for me — I'll definitely continue to contribute when I get the chance and free time.",[53,3929,3930,3931,104],{},"Basically, that's why if you want to grow professionally you ",[3932,3933,3759],"prose-a",{"target":13,"href":3934},"\u002Fposts\u002Fyou-should-start-contribute-to-open-source","2026-04-03 00:00:00 UTC","How I made first contribution — and why you should too",{},{"title":3744,"description":3936},{"loc":3934,"lastmod":3935},"posts\u002Fyou-should-start-contribute-to-open-source",[1701],"HuJak8tpDLxs7_86VzEhKzVAJYQpxzOMKpaw1dWfqZc",1795374964406]