đŸ›‘ The content of this repository has been moved to https://github.com/JetBrains/intellij-sdk-docs. Please report any issues and ideas there. The content is published at https://plugins.jetbrains.com/docs/intellij/ui-guidelines-welcome.html.
This is a repository for IntelliJ platform user interface guidelines: https://jetbrains.design/intellij/
To check out and run a local copy of the site follow the steps described below.
This site requires Jekyll. If you are not on macOS, click the links below for different OS instructions:
Install IntelliJ IDEA or WebStorm
Install bundler:
gem install bundler
Install mac developer tools:
xcode-select —install
Install ruby version manager chruby:
brew install chruby ruby-install
Open new terminal tab. Install ruby 3.0:
ruby-install ruby 3.0.0
Set ruby 3.0 as default. Add the following lines to the ~/.bash_profile or ~/.zshrc file:
source /usr/local/opt/chruby/share/chruby/chruby.sh
chruby ruby-3.0
To check out the source code run the following command:
git clone https://github.com/JetBrains/ui.git
and install the dependencies with Bundler inside the project directory:
cd ui/
bundle install
To start the web-server go to the project directory and run:
bundle exec jekyll serve
Jekyll will build the site and start a web server, which can be viewed in your browser at http://localhost:4000/.
Using Docker allows a cleaner dev environment to minimize Ruby configuration issues, as well as less need for other local macOS dependencies, e.g. Xcode command line tools. If you'd like to run Jekyll on Docker, follow these instructions:
brew install --cask docker
docker run --name intellij --volume="$PWD:/srv/jekyll" --publish 4000:4000 jekyll/jekyll jekyll serve --watch
To edit the guidelines open it in IDE. Guidelines pages are stored in _docs folder and are organised by categories. Pages are in Markdown format. See quick primer on writing in Markdown.
---
title: Combobox
category: Components
---
The site is updated on the fly, refresh the page in browser to see changes. When you finish editing, publish your changes to the repository using VCS | Commit Changes..., which allows you to either commit or commit and push.
For more details review the blog post with tips and tricks on using IDE to maintain a Jekyll site.