Per-project Atom config files.
Requires Atom v1.26 or above. This package will not work with older versions of Atom.
Atomic Management
and click Install
.Or through the command line:
apm install atomic-management
Create project specific config by adding .atom/config.cson to your project.
.atom/config.cson
).When a project directory is loaded, Atomic Management will look for a .atom/config.cson
file in the opened directory. If no such file is found, global configurations are used (as per usual). If a project file is found, it is loaded as Project Configurations and will override the global configuration when in the project's context.
This allows users to configure visual settings (font size, color, themes), disable packages, modify settings for other packages, etc. on a per-project basis without tampering with global configurations.
Users can begin using this package immediately after installation with no additional configuration other than the creation of the .atom/config.cson
file.
If you encounter issues, please submit a GitHub issue.
The .atom/config.cson
file should be specified in a syntax similar to the global config file.
Example config.cson:
"*":core: {disabledPackages: ["markdown-preview"]}editor: {tabLength: 4}"bracket-matcher":autocompleteBrackets: true".text.html.php":editor:tabLength: 8"bracket-matcher":autocompleteBrackets: false
This package supports all Atom configurations, including but not limited to:
*
(affects all files) or settings that only affect individual filetypes
core
and editor
settings
bracket-matcher
packageFor a full list of configurable content, please see the official Atom documentation here.
Features that pertain explicitly to styling, such as font color, can be changed by creating themes and placing them in the core
array. See here for more details on creating themes.
When local configuration files are active, a gear icon will appear on the lower left side of the Atom window. When clicked, this status bar button will display the local configuration files that are currently active and allow you to activate, deactivate, or rearrange the order of the local project configurations.
The settings described in the .atom/config.cson
file will override the global Atom configuration, and each operates independently of each other.
If you wish to change settings on a per-project level, directly edit/create the .atom/config.cson
under the project's root directory. If you wish to change global settings, directly edit the global configuration either through Edit > Config
on Windows/Linux or Atom > Config
on Mac.
In Packages > Atomic Management
, select the option Reset Remembered Config
.
You can quickly open up the active per-project config file by selecting
Packages > Atomic Management > Open Active Config File
.
No. This package only manages settings that are available through Atom's global config.cson
file. Atom manages keybindings through a separate keymap.cson file.
If you receive the error message:
Uncaught TypeError: Cannot read property 'isEqual' of undefined
Try clearing your Electron cache. For instructions on how to do this, see here.
Good catch. Let us know what about this package looks wrong to you, and we'll investigate right away.