Development environment
The language server is written in TypeScript and runs both in Node and the browser. While the server can be used outside of Visual Studio Code, it's recommended to use VS Code for development.
You need:
- A long-term support version of Node.js
- Visual Studio Code
Recommended extensions:
- Vitest to help run and debug individual tests.
To preview the documentation you need mdbook. If you're on macOS and use Homebrew you can brew install mdbook
.
Getting started
Clone the repo and install dependencies:
git clone git@github.com:wkillerud/some-sass.git
cd some-sass
npm install
Run the build and automated tests. Some of the automated tests open a new window and run in Visual Studio Code Insiders.
npm run build
npm run test:all
Watch mode
You can have nx
watch the workspace for changes and rerun a minimum build:
npm run dev
Some packages have watch mode for unit tests using Vitest:
packages/language-server/
packages/language-services/
In packages with Vitest you start watch mode with the test
script:
npm test
Next steps
You may want to have a look at the architecture of the language server. Most of the functionality of the language server is in the language-services
package in packages/
.
Test-driven development with Vitest and the VS Code debugger gives the shortest feedback loop.