docs: add Fully type-aware linting for Astro, Svelte, and Vue blog post by auvred · Pull Request #2456 · flint-fyi/flint

auvred · 2026-03-18T17:25:50Z

PR Checklist

Addresses an existing open issue: fixes 📝 Documentation: write a blog post about Volar.js languages support #2297
That issue was marked as status: accepting prs
Steps in CONTRIBUTING.md were taken

Overview

This is my first ever blog post, so...

vercel · 2026-03-18T17:25:55Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
flint	Ready	Preview, Comment	Mar 24, 2026 4:50am

changeset-bot · 2026-03-18T17:25:56Z

⚠️ No Changeset found

Latest commit: 80f97dd

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

auvred · 2026-03-18T17:26:33Z

packages/site/src/content/docs/blog/flawless-type-aware-linting-for-astro-svelte-and-vue.mdx

+  The traditional ESLint approach to linting TS-based languages has been a pain for a very long time.
+  It is hard to configure, and it has a lot of limitations that don't allow type-aware rules to work as well as they should.
+  Learn how Flint's architecture solves this once and for all!
+title: Flawless type-aware linting for Astro, Svelte, and Vue


I'm not sure, but this heading may be a bit too clickbait-ish. If so, I can change it to something less strong.

It's not clickbait (IMO), it's true :)

Oh boy finding the right balance of clickbait-y-ness is such a struggle... I still wish I'd figured out something slightly less extravagant for https://typescript-eslint.io/blog/typed-linting.

Although "flawless" is technically correct in reference to just the types in linting, I suspect using it here makes it seem like we're claiming that all Flint linting (for these languages) is flawless. Which is a bit more than we should.

Maybe... "Fully" instead of "Flawless"?

I still wish I'd figured out something slightly less extravagant for typescript-eslint.io/blog/typed-linting.

For the record, I remember liking the title :)
Maybe I just have a thing for clickbait though? 🤷🏻‍♂️

At this point it's indeed flawless, because I haven't yet discovered any non-fixable limitation. Although, if at some point we find one, then this title would be a lie...

Maybe... "Fully" instead of "Flawless"?

"Fully" doesn't show that we solved some actual flaws 🤔

Maybe something like:

Rethinking type-aware linting for Astro, Svelte, and Vue

Type-aware linting for Astro, Svelte, and Vue, done right

Closing the gaps in type-aware linting for Astro, Svelte, and Vue

I like "done right" better but if we're trying to stay objective, "Closing the gaps" is probably best.

Maybe 🌶️: we don't have to be completely objective. We can promote ourselves a little bit. "Fully" is still top in my mind because it implies other linters aren't full (which is objectively true!).

But "closing the gaps" sounds good to me too.

Okay, so the new title is "Fully type-aware linting for Astro, Svelte, and Vue blog post"!

lishaduck · 2026-03-18T19:23:22Z

This is my first ever blog post, so...

So you should start a blog. 🙃 It was great!
I'll try to find some time to write down my feedback but if I don't find time to do that, I'd be happy to just release it as-is.

lishaduck

Overall, fantastic blogpost!

Approving b/c 1) it's mostly style comments and I trust you to do with them what you want and 2) I don't want to be AFK and block this landing on time.

packages/site/src/content/docs/blog/flawless-type-aware-linting-for-astro-svelte-and-vue.mdx

packages/site/src/content/docs/blog/fully-type-aware-linting-for-astro-svelte-and-vue.mdx

packages/site/src/content/docs/blog/flawless-type-aware-linting-for-astro-svelte-and-vue.mdx

Co-authored-by: Eli <88557639+lishaduck@users.noreply.github.com>

lishaduck

Amazing! 😍

packages/site/src/content/docs/blog/flawless-type-aware-linting-for-astro-svelte-and-vue.mdx

JoshuaKGoldberg

Wow. Wowwow! Great post @auvred. I had a fantastic time reading through it. It thoroughly answers a lot of the questions I had coming into reviewing the work: why Volar, why set the transforms up the way it does, and how it all works together for Flint. Awesome writing! 👏

I left a bunch of comments internally, but don't want to be prescriptive for any of them. Please do push back if you think I'm wrong, especially on the [Content] notes!

packages/site/src/content/docs/blog/flawless-type-aware-linting-for-astro-svelte-and-vue.mdx

packages/site/src/content/docs/blog/fully-type-aware-linting-for-astro-svelte-and-vue.mdx

packages/site/src/content/docs/blog/flawless-type-aware-linting-for-astro-svelte-and-vue.mdx

Co-authored-by: Josh Goldberg ✨ <github@joshuakgoldberg.com> Co-authored-by: Eli <88557639+lishaduck@users.noreply.github.com>

auvred · 2026-03-22T10:33:26Z

I think I've addressed all reviews (?) Not resolved review commits have a few pending discussions

JoshuaKGoldberg

Progress!

I might have run out of time to review tonight but want to get you these thoughts ASAP. Will post more soon 🚀.

This blog post is freaking great though. I'm mostly going through in the mindset of an editor, trying to tighten up phrasing the way my editors have done for me. IMO we could absolutely ship as-is and it'd be great. Just, you know, perfectionism 😁

packages/site/src/content/docs/blog/fully-type-aware-linting-for-astro-svelte-and-vue.mdx

JoshuaKGoldberg · 2026-03-23T00:14:38Z

packages/site/src/content/docs/blog/fully-type-aware-linting-for-astro-svelte-and-vue.mdx

+[90m╰[39m
+
+[31m✖ Found [1m3 reports[22m across [1m2 files[22m.[39m
+```


[Non-Actionable] Just cross-linking #1287 for reference. That'd be nice. I'll ping @Yonava; I know they've got a lot going on these days.

JoshuaKGoldberg · 2026-03-23T03:34:40Z

packages/site/src/content/docs/blog/fully-type-aware-linting-for-astro-svelte-and-vue.mdx

+  title: Maintainer
+  picture: /team/auvred.webp
+  url: https://github.com/auvred
+date: 2026-03-18


How do you feel about, say... Tuesday?

Suggested change

date: 2026-03-18

date: 2026-03-24

JoshuaKGoldberg

This is it for now. It's feeling good!!

packages/site/src/content/docs/blog/fully-type-aware-linting-for-astro-svelte-and-vue.mdx

JoshuaKGoldberg

Hell yeah! Thanks and 👏 for all your hard work on this post. It does a great job of explaining a ton of awesome deep technical work you powered through, in a way that's actually really approachable and fun. I think people are going to be enamored with this.

Because I've gone over this so much, I think I'm no longer objectively able to edit it. In an ideal world we would have another deep editing pass. But, you know, it's pretty great. I'm happy with merging as soon as you & any other reviewing team members are.

Whoo!

packages/site/src/content/docs/blog/fully-type-aware-linting-for-astro-svelte-and-vue.mdx

auvred · 2026-03-24T04:52:00Z

all your hard work on this post

You've probably done even bigger work than I have xD

So thank you for the thorough reviews!

This pr has the highest number of comments in Flint's repo

I think I've addressed all comments, so there is nothing blocking. Feel free to edit the PR directly if you spot any inconsistencies before merging!

JoshuaKGoldberg · 2026-03-25T02:56:05Z

@all-contributors please add @auvred for doc.

🤖 Beep boop! This comment was added automatically by all-contributors-auto-action.
Not all contributions can be detected from Git & GitHub alone. Please comment any missing contribution types this bot missed.
...and of course, thank you for contributing! 💙

allcontributors · 2026-03-25T02:56:16Z

@JoshuaKGoldberg

I've put up a pull request to add @auvred! 🎉

auvred commented Mar 18, 2026

View reviewed changes

done

61ef5cf

auvred force-pushed the volar-blog-post branch from 9d096fd to 61ef5cf Compare March 18, 2026 17:27

vercel bot deployed to Preview March 18, 2026 17:31 View deployment

lishaduck approved these changes Mar 19, 2026

View reviewed changes

Apply suggestions from code review

5f338e7

Co-authored-by: Eli <88557639+lishaduck@users.noreply.github.com>

vercel bot deployed to Preview March 19, 2026 05:33 View deployment

auvred added 2 commits March 19, 2026 08:34

extension language -> TS-based language

ace7edf

f255c47

vercel bot deployed to Preview March 19, 2026 05:54 View deployment

oops

494e412

vercel bot deployed to Preview March 19, 2026 06:43 View deployment

lishaduck approved these changes Mar 19, 2026

View reviewed changes

packages/site/src/content/docs/blog/flawless-type-aware-linting-for-astro-svelte-and-vue.mdx Outdated Show resolved Hide resolved

packages/site/src/content/docs/blog/flawless-type-aware-linting-for-astro-svelte-and-vue.mdx Outdated Show resolved Hide resolved

upd

a633edb

vercel bot deployed to Preview March 19, 2026 16:15 View deployment

JoshuaKGoldberg requested changes Mar 22, 2026

View reviewed changes

JoshuaKGoldberg added the status: waiting for author Needs an action taken by the original poster label Mar 22, 2026

Apply suggestions from code review

80227ea

Co-authored-by: Josh Goldberg ✨ <github@joshuakgoldberg.com> Co-authored-by: Eli <88557639+lishaduck@users.noreply.github.com>

vercel bot deployed to Preview March 22, 2026 09:22 View deployment

auvred added 2 commits March 22, 2026 12:29

JS/TS -> JavaScript/TypeScript

8830bc8

themed volar labs screenshot

e8a932c

auvred changed the title ~~docs: add Flawless type-aware linting for Astro, Svelte, and Vue blog post~~ docs: add Fully type-aware linting for Astro, Svelte, and Vue blog post Mar 22, 2026

auvred added 4 commits March 22, 2026 12:42

flawless -> fully

e42d7b7

expand

e9d8b15

dense vue example

810d35b

whats next

a93d332

github-actions bot removed the status: waiting for author Needs an action taken by the original poster label Mar 22, 2026

vercel bot had a problem deploying to Preview March 22, 2026 10:33 Failure

discord link

67c2ac5

vercel bot deployed to Preview March 22, 2026 10:50 View deployment

JoshuaKGoldberg requested changes Mar 23, 2026

View reviewed changes

JoshuaKGoldberg reviewed Mar 23, 2026

View reviewed changes

auvred added 3 commits March 23, 2026 17:22

description & rephrase no-unsafe rules

1e70462

get rid of complex diagrams

381d3d6

tweaks

73ebd24

vercel bot deployed to Preview March 23, 2026 15:18 View deployment

svelte-check & ngtsc

66d1f70

vercel bot deployed to Preview March 23, 2026 15:26 View deployment

8837912

vercel bot deployed to Preview March 23, 2026 15:33 View deployment

auvred requested a review from JoshuaKGoldberg March 23, 2026 16:03

proofreading

5da9eaa

vercel bot deployed to Preview March 23, 2026 16:28 View deployment

JoshuaKGoldberg approved these changes Mar 24, 2026

View reviewed changes

JoshuaKGoldberg mentioned this pull request Mar 24, 2026

📝 Documentation: Point root README.md to the site #2497

Closed

2 tasks

JoshuaKGoldberg reviewed Mar 24, 2026

View reviewed changes

packages/site/src/content/docs/blog/fully-type-aware-linting-for-astro-svelte-and-vue.mdx Show resolved Hide resolved

tweaks

80f97dd

vercel bot deployed to Preview March 24, 2026 04:50 View deployment

auvred merged commit 0f135c6 into main Mar 25, 2026
8 checks passed

auvred deleted the volar-blog-post branch March 25, 2026 02:55

allcontributors bot mentioned this pull request Mar 25, 2026

docs: add auvred as a contributor for doc #2503

Merged

JoshuaKGoldberg mentioned this pull request Mar 25, 2026

docs: update root README.md description with current site links #2498

Merged

3 tasks

Conversation

auvred commented Mar 18, 2026

PR Checklist

Overview

Uh oh!

vercel bot commented Mar 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot bot commented Mar 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

lishaduck commented Mar 18, 2026

Uh oh!

lishaduck left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

lishaduck left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

JoshuaKGoldberg left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

auvred commented Mar 22, 2026

Uh oh!

JoshuaKGoldberg left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

vercel bot commented Mar 18, 2026 •

edited

Loading

changeset-bot bot commented Mar 18, 2026 •

edited

Loading