Home

Awesome

<p align="center"> <a href="https://marketplace.visualstudio.com/items?itemName=piotrpalarz.vscode-gitignore-generator"> <img width="192" src="https://github.com/piotrpalarz/vscode-gitignore-generator/raw/master/images/readme/icon_big.png" alt=".gitignore Generator"> </a> </p> <p align="center"> <a href="https://marketplace.visualstudio.com/items?itemName=piotrpalarz.vscode-gitignore-generator">View in Visual Studio Marketplace</a> </p> <p align="center"> <img src="https://vsmarketplacebadge.apphb.com/version/piotrpalarz.vscode-gitignore-generator.svg?label=Version" alt=".gitignore Generator version"> <img src="https://vsmarketplacebadge.apphb.com/installs/piotrpalarz.vscode-gitignore-generator.svg?label=Installs" alt=".gitignore Generator installs"> <img src="https://vsmarketplacebadge.apphb.com/rating-short/piotrpalarz.vscode-gitignore-generator.svg?label=Rating" alt=".gitignore Generator rating"> </p>

.gitignore Generator for Visual Studio Code

Lets you easily and quickly generate .gitignore file for your project using gitignore.io API.

Features:

Why do I need that?

Did you know that your operating system can store a lot of hidden files in every directory you create? How about .DS_Store or Icon? on macOS or Thumbs.db and Desktop.ini on Windows? These are certainly not the files you want to commit to a Git repository.

And what about other files and directories used by various frameworks and tools? These may be node_modules for Node.js or vendors for PHP projects using Composer. And this is only the tip of the iceberg, so you can't possibly know every file that should be excluded from being commited to a repository.

That's where gitignore.io API comes in handy. It allows you to pick and choose tools, frameworks or operating system you're working with and it generates .gitignore file containing all the exclusions you need for those. You can, of course, use the website manually and then save the generated .gitignore file but leaving your editor to do just that is counterproductive.

Using this extension for Visual Studio Code you can achieve exactly that without ever leaving the editor (or even touching a mouse).

Installation

To install this extension go to View->Extensions and search for .gitignore Generator. Next click Install and then Reload.

Usage

The main purpose of this extension is to generate .gitignore file but it's also smart enough to know if you already have one or if you added your custom rules to it. It's also OS-aware so it prechecks that checkbox for you.

To use the extension go to the Command Palette (Shift+CMD+P on macOS or Shift+CTRL+P on Windows) and launch Generate .gitignore File command.

Case 1: You don't have .gitignore file yet

If you don't have .gitignore file already you'll be prompted right away with the list of all available tools, frameworks etc. to choose from. You can select or deselect the item with Space or by clicking the checkbox. Fuzzy-search is also available to speed things up.

Once you finished press Return (Enter) and your .gitignore file will be generated and saved on the disk.

Generate .gitignore file

Case 2: You already have .gitignore file generated by this extension

If you generated .gitignore file before you'll be asked if you want to override it entirely or just update it. If you choose former option everything goes like described in Case 1. If you choose Update, all previously chosen items will be checked automatically so you don't have to do it again. Now you can choose other technologies or remove ones that you already have selected but don't want to use anymore.

Warning! If you have .gitignore file that was not generated using this extension, updating will remove its content.

Update .gitignore file

User-defined rules

The cool thing is that using this extension doesn't mean that you can't put your own exclusion rules in .gitignore file for fear of loosing them when you run Update command again.

Everything you put under # Custom rules ... (at the bottom of the file) will be preserved on the next update.

Warning! If you choose Override option your custom rules will be lost.

User-defined rules in .gitignore file

Multi-folder workspace

If you have more than one folder open in the workspace you'll be asked which one to use to generate .gitignore file into or update that file from.

Available commands

Currently only one command is available:

By default, it's not bound to any keyboard shortcut but you're free to do so.

Roadmap

Although this extension works well I'm planning to add some extra features to it in the future. Some of them are:

Issues

If you find any problems using this extension or you want to propose new features to it, feel free to open an issue on Github.

Credits

This project wouldn't be possible without already great gitignore.io API created by Joe Blau (@joe_blau). Thanks!