calionauta/datastar-lint

datastar-lint is a command line tool that checks projects using Datastar, a library for building interactive web pages, for mistakes that would normally only show up later, in the browser or over a live connection to the server. Datastar works through special data attributes placed on HTML elements and matching function calls in backend code, and this tool looks at both sides at once, across Go, Python, and TypeScript projects. The problem it solves is that many Datastar mistakes compile and build without any error. A misspelled attribute like data on clik is silently ignored by the browser. Calling a backend function to patch elements without telling it which part of the page to target throws an error only when the page actually runs. A formatting mismatch in a Go function call is not caught by the Go compiler. Sending an empty update can quietly wipe out all of an application's stored state. This tool moves all of these problems from something discovered after the app is running to something caught automatically before that, in a continuous integration pipeline. It installs as a single Go binary and requires Go version 1.26 or newer to install, though using it does not require every project to be written in Go. Once installed, it can check HTML, Templ, TSX, JSX, and plain JavaScript or TypeScript files for attribute mistakes by default, and can additionally be told to inspect Go, Python, or TypeScript backend code for its own set of checks specific to that language's Datastar calls. Running it against a folder produces a list of warnings or errors and returns a simple pass or fail result that other tools, like a build pipeline, can act on. Projects that intentionally use custom data attributes that are not part of Datastar can list them in a small configuration file so the linter stops flagging them, while genuine typos are still reported with a suggested correction. The tool also quietly checks in the background whether a newer version of itself is available and can update itself when asked.