Fetching contributors…
Cannot retrieve contributors at this time
222 lines (149 sloc) 6.98 KB

.ignore 3.0.0

Gitter Build Status

Donate Backers on Open Collective Sponsors on Open Collective

Version Downloads Downloads last month


.ignore is a plugin for:

  • .gitignore (Git)
  • .hgignore (Mercurial)
  • .npmignore (NPM)
  • .dockerignore (Docker)
  • .chefignore (Chef)
  • .cvsignore (CVS)
  • .bzrignore (Bazaar)
  • .boringignore (Darcs)
  • .mtn-ignore (Monotone)
  • ignore-glob (Fossil)
  • .jshintignore (JSHint)
  • .tfignore (Team Foundation)
  • .p4ignore (Perforce)
  • .flooignore (Floobits)
  • .eslintignore (ESLint)
  • .cfignore (Cloud Foundry)
  • .jpmignore (Jetpack)
  • .stylelintignore (StyleLint)
  • .stylintignore (Stylint)
  • .swagger-codegen-ignore (Swagger Codegen)
  • .helmignore (Kubernetes Helm)
  • .upignore (Up)
  • .prettierignore (Prettier)
  • .ebignore (ElasticBeanstalk)

files in your project. It supports following JetBrains IDEs:

  • Android Studio
  • AppCode
  • CLion
  • IntelliJ IDEA
  • PhpStorm
  • PyCharm
  • RubyMine
  • WebStorm
  • DataGrip


  • Files syntax highlight
  • Coloring ignored files in the Project View
  • Gitignore templates filtering and selecting in rules generator by name and content
  • User custom templates
  • Show ignored files by specified Gitignore file (right click on .gitignore file)
  • Create file in currently selected directory
  • Generate Gitignore rules basing on GitHub's templates collection
  • Add selected file/directory to Gitignore rules from popup menu
  • Suggesting .gitignore file creation for new project
  • Entries inspection (duplicated, covered, unused, incorrect syntax, relative entries) with fix actions
  • Comments and brackets support
  • Navigation to entries in Project view
  • Renaming entries from ignore file
  • Close opened ignored files action
  • Custom user templates with import/export features

Supported IDEs

Since v3.1.0, .ignore plugin updates will be delivered to the IDE in version of 171+ - so all builds from 2017+.

But hey, no worries! It means .ignore for all IDE version from before - 139-163 - will be freezed at v3.0.0.


  • Using IDE built-in plugin system:
    • Preferences > Plugins > Browse repositories... > Search for ".ignore" > Install Plugin
  • Manually:
    • Download the latest release and install it manually using Preferences > Plugins > Install plugin from disk...

Restart IDE.


  1. Generate new file and templates usage

    To generate new ignore file, just click on File > New or use Alt + Insert shortcut and select .ignore file element.

    Generate new file

  2. Support for typing new rules, linking rules with matched files

    Support for typing new rules

  3. Code inspections

    Code inspections covers few cases:

    • duplicated entries (checks if entry is defined more than once)
    • covered entries - entry is covered by more general one
    • unused entries
    • incorrect syntax (regexp rules)
    • relative entries

    Code inspections


v3.1.0 (unreleased)

Full Changelog

Fixed bugs:

  • Adding 2+ templates without new line in between #561

Full Changelog History


Check file.

Compiling the source code

Since the project has been migrated to the Gradle and Gradle IntelliJ plugin, the build process is much simpler. The only thing to build the plugin is to run:

gradle build

All required dependencies like Grammar-Kit, JFlex are downloaded in the background and triggered properly during the build process. You can also test the plugin easily with running:

gradle runIdea

All of the gradle tasks can be connected to the IntelliJ debugger, so the development process is very easy.

Developed By

@hsz Jakub Chrzanowski



Support us with a monthly donation and help us continue our activities.



Become a sponsor to get your logo on our README on Github.



I'm using Yourkit to locate and fix performance issues of .ignore. YourKit, LLC kindly provided a free open-source license of the YourKit Java Profiler.

YourKit Java Profiler Logo


Copyright (c) 2018 hsz Jakub Chrzanowski. See the LICENSE file for license rights and limitations (MIT).