// Tutorial //

Linting TypeScript Vue.js Components with Wotan

Published on April 23, 2018
Default avatar

By Joshua Bemenderfer

Linting TypeScript Vue.js Components with Wotan

While we believe that this content benefits our community, we have not yet thoroughly reviewed it. If you have any suggestions for improvements, please let us know by clicking the “report an issue“ button at the bottom of the tutorial.

TypeScript is a special language. People tend to either love it or vehemently hate it (though it seems like most of those who’ve tried it, love it). Regardless of your opinion, TypeScript can be quite convenient at times. But, it can be a pain to get it working properly with Vue. Since TypeScript uses its own linting and compiling tools, integrating it into an existing toolchain can be quite an exploration of arcane arts. Getting TypeScript to lint, for example, Vue Single File Components, cannot be directly done by tslint. You have to go through some convoluted code transforms and such to be able to get something remotely workable. But what if there was another way? Enter wotan, a pluggable TypeScript and JavaScript linter. It has plugins for Vue Single File Components and can bolt right on to your existing tslint project.

Let’s take a look at how we can get Vue Single File Components linted using wotan.

This tutorial assumes you’ve got a project already set up with TypeScript. Something along the lines of Microsoft’s official TypeScript-Vue Starter Project

We’re going to need three packages:

  1. The wotan CLI. Does the usual things that CLIs do.
  2. - A preprocessor for Wotan that extracts scripts from Vue Single File Components for linting.
  3. Valtýr - A plugin for Wotan that effectively works as a drop-in replacement for tslint. It can use your tslint.json files unchanged.
$ npm install --save-dev @fimbul/wotan @fimbul/ve @fimbul/valtyr

Configure Wotan

Create a new file called .fimbullinter.yaml. This holds the configuration that tells wotan how to lint your project.

# Tell wotan to use the valtyr module for linting.
modules: "@fimbul/valtyr"
# Valtýr configuration.
    # Use the Vé preprocessor for all *.vue files.
    # Valtýr will still run for *.ts files by default.
    - files: "*.vue"
      processor: "@fimbul/ve"


Now, you can lint your project simply by running wotan in the project directory.

For example, here’s the output I get when running wotan on the default TypeScript-Vue Starter Project.

Wow, that's quite a few errors. Microsoft, what are you doing?


Thankfully, all of those errors can be automatically fixed using wotan --fix.

Don’t like the linter configuration? Just configure tslint.json like you would with any other TypeScript project!

At the moment, wotan is a fairly young project and doesn’t seem to have direct integration with any editors. Perhaps you could help with that?

Take a look at Wotan and Valtýr’s many options to get a feel for what they can do.

And with that, you should be good to go!

Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.

Learn more about us

About the authors
Default avatar
Joshua Bemenderfer


Still looking for an answer?

Ask a questionSearch for more help

Was this helpful?
Leave a comment

This textbox defaults to using Markdown to format your answer.

You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!

Try DigitalOcean for free

Click below to sign up and get $200 of credit to try our products over 60 days!

Sign up

card icon
Get our biweekly newsletter

Sign up for Infrastructure as a Newsletter.

Sign up
card icon
Hollie's Hub for Good

Working on improving health and education, reducing inequality, and spurring economic growth? We’d like to help.

Learn more
card icon
Become a contributor

You get paid; we donate to tech nonprofits.

Learn more
Welcome to the developer cloud

DigitalOcean makes it simple to launch in the cloud and scale up as you grow – whether you’re running one virtual machine or ten thousand.

Learn more ->
DigitalOcean Cloud Control Panel
Get started for free

Enter your email to get $200 in credit for your first 60 days with DigitalOcean.

New accounts only. By submitting your email you agree to our Privacy Policy.

© 2023 DigitalOcean, LLC.