{"id":24623247,"url":"https://github.com/ventojs/webstorm-vento","last_synced_at":"2026-01-17T08:03:46.460Z","repository":{"id":273515545,"uuid":"919970485","full_name":"ventojs/webstorm-vento","owner":"ventojs","description":"Vento support for JetBrains's WebStorm, IntelliJ (also PyCharm, and PHPStorm)","archived":false,"fork":false,"pushed_at":"2026-01-15T00:32:15.000Z","size":5073,"stargazers_count":2,"open_issues_count":10,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-15T05:47:18.438Z","etag":null,"topics":["intellij-plugin","jetbrains-plugin","kotlin","plugin","vento-for-jetbrains-s-webstorm-ide","webstorm-plugin"],"latest_commit_sha":null,"homepage":"https://vento.js.org/","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ventojs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-01-21T10:38:36.000Z","updated_at":"2026-01-15T00:21:28.000Z","dependencies_parsed_at":"2025-03-26T00:20:21.998Z","dependency_job_id":"c14557ac-558b-4f64-8fc7-5acf917b2862","html_url":"https://github.com/ventojs/webstorm-vento","commit_stats":null,"previous_names":["illyrius666/webstorm-vento","ventojs/webstorm-vento"],"tags_count":8,"template":false,"template_full_name":"JetBrains/intellij-platform-plugin-template","purl":"pkg:github/ventojs/webstorm-vento","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ventojs%2Fwebstorm-vento","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ventojs%2Fwebstorm-vento/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ventojs%2Fwebstorm-vento/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ventojs%2Fwebstorm-vento/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ventojs","download_url":"https://codeload.github.com/ventojs/webstorm-vento/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ventojs%2Fwebstorm-vento/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28504358,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T06:57:29.758Z","status":"ssl_error","status_checked_at":"2026-01-17T06:56:03.931Z","response_time":85,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["intellij-plugin","jetbrains-plugin","kotlin","plugin","vento-for-jetbrains-s-webstorm-ide","webstorm-plugin"],"created_at":"2025-01-25T03:57:22.278Z","updated_at":"2026-01-17T08:03:46.442Z","avatar_url":"https://github.com/ventojs.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e \u003ca href=\"https://vento.js.org/\"\u003e \u003cimg src=\"assets/favicon.svg\" alt=\"VentoJS Logo\" width=\"200\"\u003e\u003c/a\u003e \u003c/h1\u003e\n\u003cdiv align=\"center\"\u003e\n\n[![Contributors][contributors_shield_url]][contributors_url]\n[![Issues][issues_shield_url]][issues_url]\n\n\u003c/div\u003e\n\n\u003c!-- Plugin description --\u003e\n\u003ch2\u003e Vento plugin\u003c/h2\u003e\n\u003ch3\u003efor JetBrain's WebStorm \u0026 IntelliJ IDEA Ultimate IDE \u003c/h3\u003e\n\u003cp\u003e\nProvides support for the \u003ca href=\"https://vento.js.org/\"\u003eVentoJs\u003c/a\u003e template engine. Vento is used in the SSG  \u003ca href=\"https://lume.land/\"\u003eLume\u003c/a\u003e framework to generate HTML sites.\n\u003c/p\u003e\n\u003ch3\u003ekey features:\u003c/h3\u003e\n\u003col\u003e\n    \u003cli\u003e`*.vto` file type\u003c/li\u003e\n    \u003cli\u003eSyntax highlighting\u003c/li\u003e\n    \u003cli\u003eSyntax checking\u003c/li\u003e\n    \u003cli\u003eauto-completion\u003c/li\u003e\n    \u003cli\u003esupport for front-matter\u003c/li\u003e\n    \u003cli\u003esupport for the fragment plugin\u003c/li\u003e\n    \u003cli\u003eformatting\u003c/li\u003e\n    \u003cli\u003efilepath auto-completion and validity checking\u003c/li\u003e\n    \u003cli\u003ecomment toggling\u003c/li\u003e\n    \u003cli\u003e\n        new features in Vento 2.2 \u0026 2.3\n        \u003col\u003e\n            \u003cli\u003edestructured variables in `set` blocks\u003c/li\u003e\n            \u003cli\u003e`default` block\u003c/li\u003e\n            \u003cli\u003e data references in `layout` and `include` blocks\u003c/li\u003e\n        \u003c/ol\u003e\n    \u003c/li\u003e\n\u003c/ol\u003e\nFor more information visit \u003ca href=\"https://vento.js.org/\"\u003eVento\u003c/a\u003e.\n\n\u003cp\u003eIt's still early days with this plugin. auto-complete and formatting support and a few other features are still to come. Check the \u003ca href=\"https://github.com/ventojs/webstorm-vento/issues\"\u003eissues\u003c/a\u003e for details\u003c/p\u003e\n\n\u003c!-- Plugin description end --\u003e\n\n## Table of Contents\n\n- [About The Project](#about-the-project)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Built With](#built-with)\n- [Code of Conduct][code_of_conduct_url]\n- [Contributing][contributing_url]\n- [License][license_url]\n\n## About The Project\n\n`webstorm-vento` is the plugin which integrates the [Vento Template Engine](https://vento.js.org/) with JetBrain's\nIntelliJ Ultimate and WebStorm IDEs.\n\n### Features\n\n#### Implemented\n* syntax highlighting\n* syntax checking\n* auto-completion (experimental and needs improvement)\n* front-matter support (disableable in settings if not wanted)\n* fragments support\n* formatting (basic indenting support)\n* filepath auto-completion and validity verification for layout, include, and import blocks\n* comment toggling vento blocks. Use ` ⌥`+`⇧`+`⌘`+`/` on OSX, or `⌥`+`⇧`+`ctrl`+`/` on Windows.\n* support for destructured variables in `set` blocks in Vento 2.2\n* support for the `default` block in Vento 2.3\n* support for data references in `layout` and `include` blocks in Vento 2.3\n\n[//]: # (#### Planned)\n\n\n\u003e [!IMPORTANT]\n\u003e ### Note to plugin developers:\n\u003e\n\u003e * You can use IntelliJ Community or Ultimate edition for development.\n\u003e * Installing the built plugin in IntelliJ Ultimate edition or Webstorm.\n\u003e * The plugin is tested with Webstorm 2024 and 2025 and IntelliJ IDEA Ultimate 2024 and 2025.\n\n## Installation\n\n* Using JetBrains Marketplace:\n    * In the IDE go to \u003ckbd\u003eSettings/Preferences\u003c/kbd\u003e \u003e \u003ckbd\u003ePlugins\u003c/kbd\u003e \u003e \u003ckbd\u003e\n      Marketplace\u003c/kbd\u003e \u003e \u003ckbd\u003eSearch for \"WebStorm-Vento\"\u003c/kbd\u003e \u003e \u003ckbd\u003eInstall\u003c/kbd\u003e\n\n* Manually:\n    * Download from GitHub Releases, or from the [JetBrains Marketplace](https://plugins.jetbrains.com/), or build it yourself.\n    * In your IDE go to \u003ckbd\u003eSettings/Preferences\u003c/kbd\u003e \u003e \u003ckbd\u003ePlugins\u003c/kbd\u003e \u003e \u003ckbd\u003e⚙️\u003c/kbd\u003e \u003e \u003ckbd\u003eInstall plugin from\n      disk...\u003c/kbd\u003e\n\n## Usage\n\n### Design\n\nThe plugin is based on the [JetBrains Platform Plugin Template](https://github.com/JetBrains/intellij-platform-plugin-template). The [Jetbrains Plugin SDK](https://plugins.jetbrains.com/docs/intellij/developing-plugins.html) is a valuable place to understand how to build a plugin for IntelliJ IDEA.\n\nThanks to the opensource [Handlebars](https://github.com/JetBrains/intellij-plugins/tree/master/handlebars) plugin, I was able to learn and resolve some issues with the syntax highlighting. To be honest, I shamelessly coppied some code from the plugin before I understood how it worked!\n\nThe best entry point into the implementation is the [plugin.xml](src/main/resources/META-INF/plugin.xml).\n\n### Lexer\n\nThe JFlex implementation of the lexer is located in the `src/main/jflex` directory. The Lexer gets generated at build time in `src/main/gen`. It is based on [JFlex](https://jflex.de/). Be careful to understand how Jetbrains uses the lexer that is generated. There are some significant differences. See [Lexer Implementation](https://plugins.jetbrains.com/docs/intellij/implementing-lexer.html#lexer-implementation) in SDK docs.\n\nVento lexing [design diagrams](statemachine-v2.md)\n\n### Parsing\n\nConceptually, parsing is split into two parts. The base of a vento file is assumed to be an HTML document. All processing is handed over to the built-in Jetbrains HTML support. The Vento plugin takes over when the vento specific syntax is encountered.\n\n\n#### Dependencies\n\nMost of the following dependencies are provided automatically when Gradle is used to build the plugin.\n\n* Vento \u003ccode\u003e \u003e= v2\u003c/code\u003e\n* Deno \u003ccode\u003e \u003e= v2.3\u003c/code\u003e\n* IntelliJ IDEA Community or Ultimate (for now only tested with \u003ccode\u003e2025.2.*\u003c/code\u003e)\n* JDK \u003ccode\u003ev21\u003c/code\u003e\n* Gradle \u003ccode\u003ev9\u003c/code\u003e\n* Jetbrains JavaScript \u0026 TypeScript plug-in \u003ccode\u003ev251.27812.49\u003c/code\u003e\n\n#### Recommended\n\n* install [ktlint](https://pinterest.github.io/ktlint/latest/install/setup/) and the prePushHook to make sure your code\n  is formatted correctly.\n\n#### Build\n\n* Clone the repository\n* Run `./gradlew buildPlugin`\n* The plugin will be built in `build/distributions`\n* Install the plugin archive found in the `build/distributions` directory\n\n#### run tests\n\n```bash\n./gradlew test\n```\n\n##### verify Jetbrains platform compatibility\n\n```bash\n./gradlew verifyPlugin\n```\n\n##### build without caches\n\n```bash\n./gradlew clean buildPLugin --no-build-cache --no-configuration-cache\n```\n\n##### clearing caches\n\n\u003e [!TIP]\n\u003e The Jetbrains SDK depends on a lot of magical dependencies to be able to run its own IDE's in development mode. So\n\u003e sometimes there is no choice but to use the nuclear option to get a clean slate. This is likely to happen if you start\n\u003e switching the platform being targeted by the plugin in `gradle.properties` or if you change the version of the\n\u003e JetBrains SDK in `build.gradle.kts`.\n\n```bash\n./gradlew --stop          ## stop the gradle daemon\nrm -rf ~/.gradle/caches/  ## delete all caches\n```\n## AI Disclosure\n\nDevelopment of this project incorporated assistance from AI tools including OpenAI, and JetBrains AI tooling. \n\nThese tools are used for:\n* Prototyping and generating initial drafts of code\n* Refactoring and optimization suggestions\n* Writing or improving documentation\n* Exploring design patterns and solving technical issues\n\nHumans perform all final decisions, implementations, and code validations.\n\n## Built With\n\n\u003cdiv align=\"center\"\u003e\n\n[![Built With][built_with_kotlin]][kotlin]\n[![Built With][built_with_gradle]][gradle]\n[![Built With][built_with_github]][github]\n[![Built With][built_with_idea]][idea]\n[![Built With][built_with_webstorm]][webstorm]\n\u003c/div\u003e\n\n\u003cp align=\"right\"\u003e\u003ca href=\"#readme-top\"\u003e▲\u003c/a\u003e\u003c/p\u003e\n\n[built_with_kotlin]: https://skillicons.dev/icons?i=kotlin\n[kotlin]: https://kotlinlang.org/\n\n[built_with_gradle]: https://skillicons.dev/icons?i=gradle\n[gradle]: https://gradle.org/\n\n[built_with_github]: https://skillicons.dev/icons?i=github\n[github]: https://github.com/\n\n[built_with_idea]: https://skillicons.dev/icons?i=idea\n[idea]: https://www.jetbrains.com/idea/\n\n[built_with_webstorm]: https://skillicons.dev/icons?i=webstorm\n[webstorm]: https://www.jetbrains.com/webstorm/\n\n\n[built_with_url]: https://skillicons.dev\n\n[code_of_conduct_url]: https://github.com/ventojs/webstorm-vento?tab=coc-ov-file\n\n[contributing_url]: https://github.com/ventojs/webstorm-vento/blob/main/CONTRIBUTING.md\n\n[contributors_shield_url]: https://img.shields.io/github/contributors/ventojs/webstorm-vento?style=for-the-badge\u0026color=blue\n\n[contributors_url]: https://github.com/ventojs/webstorm-vento/graphs/contributors\n\n[deps_shield_url]: https://deps.rs/repo/github/ventojs/webstorm-vento/status.svg?style=for-the-badge\n\n[deps_url]: https://deps.rs/repo/github/ventojs/webstorm-vento\n\n[issues_shield_url]: https://img.shields.io/github/issues/ventojs/webstorm-vento?style=for-the-badge\u0026color=yellow\n\n[issues_url]: https://github.com/ventojs/webstorm-vento/issues\n\n[license_url]: https://github.com/ventojs/webstorm-vento?tab=AGPL-3.0-1-ov-file\n\n[roadmap_shield_url]: https://img.shields.io/badge/Roadmap-Click%20Me!-purple.svg?style=for-the-badge\n\n[roadmap_url]: https://github.com/orgs/ventojs/projects/4\n\n[template]: https://github.com/JetBrains/intellij-platform-plugin-template\n\n[docs:plugin-description]: https://plugins.jetbrains.com/docs/intellij/plugin-user-experience.html#plugin-description-and-presentation\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fventojs%2Fwebstorm-vento","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fventojs%2Fwebstorm-vento","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fventojs%2Fwebstorm-vento/lists"}