Version 3.27

18 April 2024

Build 34576 — Download

ESLint Changes

• ESLint 9.0 drops support for the handy "environment" options (browser, jQuery, etc.) and instead makes YOU responsible for knowing what global variables are needed for a given environment.
• That's dumb.
• CodeKit has always been about getting rid of friction, so the environment options continue to work just as they always have—I simply reimplemented what ESLint dropped.
• ESLint 9 also drops support for .eslintrc files, so those options have disappeared from the UI.

Component Updates:

Version 3.26

7 November 2023

Build 34564 — Download

Improvements:

• App go more vroom. CodeKit has always been fast and has always compiled on background threads. This release is even faster because it migrates many tools to Swift Concurrency, which reduces thread-shifting overhead in the macOS kernel.
• The UI is now more fingerprint resistant.

Deprecations:

• Libsass: it's going away. It hasn't been updated in years and Dart Sass is the official standard now. The next release will drop Libsass.
• ESLint Formatting Rules: ESLint deprecated 30+ rules that enforce only style, not code-correctness. These rules will disappear in the future.
• My Space Gray MacBook Pro From 10 Months Ago: I am embarrassed to be seen with it.

Component Updates:

Version 3.25

27 August 2023

Build 34518 — Download

Improvements:

• Resolves UI glitches on the macOS Sonoma betas.

Component Updates:

Version 3.24

8 August 2023

Build 34513 — Download

Improvements:

• The cache buster now skips canonical links: <link rel="canonical" href="...">
• I'm aware of UI-related issues on the macOS Sonoma betas. Apple always fixes those before the GM release and CodeKit will be ready when Sonoma goes live.

Fixed:

• Creating a new Zurb Foundation project might crash the app.
• "Might" is doing a lot of work there.

Component Updates:

Version 3.23.1

16 June 2023

Build 34510 — Download

npm 9.x

• Until now, CodeKit has used an older version of npm because the devs broke JSON support two years ago and never fixed it.
• They still haven't.
• Some packages require a newer version of npm, so I've finally been forced to update it.
• As a side-effect, CodeKit's log can no longer tell you which packages were installed/removed/updated, just how many were.
• The UI for the packages area is the same—this change affects only the messages you see in the log.

Fixed:

• The "New Bootstrap Project" template is updated to work with the latest version of Bootstrap.
• The .1 update fixes a few Babel plugins for those poor bastards who—presumably because they committed genocide in a past life—are forced to configure Babel manually.

Component Updates:

Version 3.22

17 April 2023

Build 34484 — Download

TypeScript 5.0

• If your TS files were previously set to compile to ES3, they will now be set to target ES2018 instead.
• If you previously used Experimental Decorators, the syntax has changed. You can re-enable the old style with the new "Legacy Experimental Decorators" option.
• Some options have been removed and new ones added. I'm sure they're very important.

Fixed:

• A crash that might happen when compressing JSON files.
• UI glitches in the Hooks editor on macOS Ventura.
• A large performance regression in the last version of Dart Sass.
• An issue where it was possible to find tweets that did not mention ChatGPT.

Component Updates:

Version 3.21

12 March 2023

Build 34472 — Download

Fixed:

• Installing packages that require cloning with Git might hang on Apple Silicon Macs without Rosetta 2 installed.
• An issue where Silicon Valley had too many banks.

Rollup External Modules:

By default, if you import an external JS module but don't use any code from it, Rollup assumes you still need the import because the module does something else that's important. You can now disable this assumption in Project Settings > Rollup, if needed.

Component Updates:

Version 3.20

12 January 2023

Build 34448 — Download

Changes:

• You can now customize which comments Terser removes during JS minification.
• Fixed a crash in the "Apply Best Defaults for Build Folders" routine.
• Apparently lied about fixing that crash three updates ago.
• If you hate yourself enough to still be using Bower in 2023, Rollup will no longer resolve Bower imports during JS bundling. Switch to npm.

Component Updates:

Version 3.19

23 September 2022

Build 34434 — Download

Bootstrap:

• The JS file that bundles Bootstrap components is now named so that you can access it from external scripts using the standard new bootstrap.Popover(...) syntax.
• This has no effect on existing projects; only ones you create from now on.

Other Changes:

• The Projects Sidebar (you knew that was a thing, right?) sometimes didn't show disabled Projects as disabled.
• When installing npm packages, the target Project is no longer explicitly disabled, but CodeKit still ignores file-change events in that Project until the installation completes.
• Adds support for the Dynamic Island.

Component Updates:

Version 3.18.2

22 August 2022

Build 34418 — Download

Resolves potential crashes introduced by the Swift 5.5 compiler.

Component Updates:

Version 3.18.1

5 August 2022

Build 34408 — Download

3.18.1 resolves a potential AppleScript crash on macOS 12.5.

Changed:

• Updated the Bootstrap starter project to support Bootstrap 5.2+
• When an optimized image is larger than the original, the UI now highlights that in red.
• This happens if you take an optimized image and re-optimize it at a much higher quality setting.
• Don't do that.

TypeScript:

• TypeScript has a new Module Detection option to control how TS scans for ES6 vs CommonJS modules.
• This is unrelated to the Module Resolution option that has existed forever.
• There's 37 paragraphs of gibberish on the TypeScript blog that explains the option.
• "Explains" is a strong word.

Component Updates:

Version 3.17.1

4 May 2022

Build 34365 — Download

Changed:

• ESLint regrouped its 3,451 rules.
• Some of the rules in the new "suggested" group would make me "suggest" that the person who selected rules for that group "introduce" their "face" to a "wall" repeatedly.
• Violence is apparently frowned upon by HR.
• *.woff and *.woff2 files will no longer be cache-busted because Chrome whines when they are.
• Dart Sass is finally fully-native on Apple Silicon, so it's faster than ever.

Fixed:

• Kit @import statements incorrectly ignored spaces in file paths.
• Double-clicking files in the list would sometimes not work correctly.
• 3.17.1 fixes a crash that might occur if you removed a project while the Build pane was open.

Component Updates:

Version 3.16.1

29 December 2021

Build 34335 — Download

(3.16.1 fixes an issue where Tailwind files might not compile correctly.)

NEW: Bootstrap 5

• CodeKit can now automatically spin up a Bootstrap 5 Project.
• Choose File > New Bootstrap Project
• Watch the screencast or read the docs for details.

NEW: Tailwind 3.x

• New Tailwind Projects now default to Tailwind 3.x
• The new "JIT Mode" is automatically supported for these projects.
• Legacy Tailwind 2.x projects still work just fine, too.

Different:

• New option in Preferences: CodeKit can now auto-switch the active project when you save files.
• I did not test what happens if you save files from 15 different projects at once.
• I recommend that you also not test what happens if you save files from 15 different projects at once.
• Files changed by replacement via drag-n-drop in the Finder are now processed automatically again.
• CoffeeLint was discontinued and hadn't been updated in five years. It's removed.

Also Different:

• Dart Sass 1.45.1 has a couple potentially-breaking changes you should read about.
• CodeKit now requires macOS 10.15+ because Xcode 13.2 got dumber. (There's a bug in the build process that causes crashes on 10.13 and 10.14.)
• Yes, I told Apple.
• Yes, Apple ignored me.
• Yes, that's how it always goes.
• Yes, I'm looking forward to WWDC 2022, where Apple will once again lie to promise me how valuable and important I am and how we're "partners" working to "inspire dreams."

Component Updates:

Version 3.15.1

18 November 2021

Build 34264 — Download

Changed:

• Pop-up buttons are no longer comically oversized on Monterey.
• Added HDMI port & SD card slot.
• Did Babel's job for them (see below).
• Increased app thickness to fill new $3,500 hole in wallet caused by HDMI port and SD card slot.

Async/Await

• To use "async/await" in your JS, go to Project Settings > Babel and set the useBuiltIns option to "Usage".
• When you do, CodeKit now verifies that you have the right dependencies installed and offers to install them if needed.
• Could have saved, like, 6,000 support emails if I had done this five years ago.

Component Updates:

Version 3.15

17 September 2021

Build 34214 — Download

Tailwind JIT:

• Tailwind's new JIT mode is now fully supported.
• Add mode: 'jit' to your tailwind.config.js file, save, and then refresh the project in CodeKit.
• No other configuration is needed; CodeKit will take it from there.

Improved:

• Node.js is now native on M1 Macs, making just about every tool in the app faster.

Fixed:

• The chevrons in outlineViews were sometimes the wrong color.
• The shadows around buttons disappeared if you toggled dark mode, making buttons hard to see.
• The 'emit character set' option for Dart Sass actually works now.
• Terser's 'reserved names' list is now always honored.
• Sublime Text 4 appears in code editor menus.

We're Breaking Up:

This release removes Compass, which was end-of-lifed 5 years ago. It also removes JSHint and JSLint. If you were still using those, JS files will switch to ESLint automatically.

Component Updates:

Version 3.14.4

19 March 2021

Build 34127 — Download

Things That Got Better:

• The Environment option can now be changed from the Project Inspector.

Things That Were Supposed To Have Gotten Better Last Time:

Sweet, merciful Christ I think PurgeCSS is finally good to go.

• First, I modified PurgeCSS to support skipping folders.
• Next, I added that to the UI in Project Settings > PurgeCSS
• End result: PurgeCSS won't scan the "node_modules" folder anymore.

Things That Suck Less:

• If you have a typo in your package.json file, the error message in the log is more helpful in that the error message now actually shows up in the log.
• Creating a new Zurb Foundation project won't crash.
• Root-relative Pug imports now link correctly.

The Podcast

Because Ira has enough listeners: Unmuzzled.fm

Component Updates:

Version 3.14.3

4 March 2021

Build 34081 — Download

New Right-Click Options

• Right-click any file/folder and preview it directly in any web browser.
• You can now open any file's output in Finder from the right-click menu.

PurgeCSS Fix

• Remember how I said PurgeCSS would shoot you in the foot if you didn't configure it correctly?
• Turns out, the PurgeCSS docs were out of date and a thing that used to work no longer works.
• I used the thing in CodeKit 3.14.2. Because of course.
• This update fixes the thing.
• Yes, this means that *I* did not configure PurgeCSS correctly.
• In my defense, I still suck less than whoever is building the rocket engines for SpaceX.
• (Don't use the negation operator ! in PurgeCSS content entries.)

Other Fixes

• Stylus files compile without dumb warnings again.
• PostCSS no longer runs when there's nothing to do.

App go Vroooom

• Node.js is now native on Apple Silicon, so almost every tool in CodeKit is even faster.
• Intel is soooo screwed.

Component Updates:

Version 3.14.2

12 February 2021

Build 34018 — Download

(3.14.2 removes a useless Babel warning about unused options.)

(3.14.1 fixes build steps that might run out of order, a pedantic npm warning, and the HTML minifier possibly removing cache-busting queries.)

NEW TailwindCSS

• CodeKit now automatically supports TailwindCSS projects.
• Use File > New TailwindCSS Project to spin one up fast.
• Existing Tailwind projects are also supported from version 1.9.6+
• For details, read the docs or watch the screencast.

NEW PurgeCSS

• PurgeCSS is now available for CSS, Sass, Less, and Stylus files.
• It gets rid of unused CSS rules.
• If you configure it incorrectly, it gets rid of all CSS rules.
• Configure it correctly.
• To do that, read the docs or watch the screencast.
• If you email me, "CodeKit breaks my site!" and it turns out you forgot to configure PurgeCSS, I get to put a MIDI of my choice on your website for a month.
• I have "MMMBop" in MIDI.

NEW CSSO

• CSSO is a highly-tuned CSS optimizer/minifier.
• You can run it on CSS, Sass, Less, and Stylus files.
• If you set the options just right, you can have PurgeCSS shoot you in one foot and CSSO shoot you in the other.
• No, I will not share my "MMMBop" MIDI.

NEW Custom PostCSS Plugins

• CodeKit now honors your postcss.config.js file and runs any custom PostCSS plugins that you specify.
• You can install PostCSS plugins from CodeKit's Packages area, like a civilized human.
• There are important details about integrating your custom PostCSS plugins into the flow of plugins that are built into CodeKit.
• You're fresh out of feet, so the next thing you're gonna shoot off is more valuable. Better read the docs or watch the screencast, Doc Holiday.

NEW CSS Imports

• You can now (optionally) have CodeKit combine all @import-ed files in a CSS file.
• CSS files now show a "Linked Files" pane.
• You can import CSS files in the same project, an npm package, or a CodeKit Framework.
• Look, it's not important why I have an "MMMBop" MIDI.

NEW Build Environment Option

• There's a new "Environment" option in Project Settings > General.
• You can now set certain tools (PurgeCSS, CSSO, Minifiers, Source Maps, etc.) to run only in a given environment.
• The value from the PopUp Button is automatically synced with the NODE_ENV environment variable.

Big Changes:

• CodeKit now runs natively on Apple Silicon.
• Support for macOS 10.11 and 10.12 is dropped. Update your OS.

Other Changes:

• More UI has been overhauled for Big Sur.
• Rollup's "context" option is now exposed.
• You can now select hidden folders in "Choose a Folder" panels.
• The discontinued Neat framework no longer appears in the UI, but projects using it will still compile just fine.
• Tool config files are now auto-ignored unless you explicitly change their Output Action.
• The "strict math" option for Less files is removed because Less 4.0 no longer supports it.
• The entire browser-refresh server was re-written using Swift-NIO. It's faster, better, thinner, sexier, multi-threaded...it's basically Tom Brady moving forward through time.

Fixed:

• The cache buster generated different hashes for a file, even when the file's content had not changed.
• The Packages list didn't sort correctly when reloaded.
• Certain dependency links between Kit files weren't detected until a Project was refreshed.
• Browser Refreshing might break if you used the back button in your browser.
• Ugh, fiiiiiiiiiine.

Got Five Dollars?

I have a show: Unmuzzled.fm
We charge $5 for ads. Our intros are provided by OnlyFans people. Hilarity ensues.

Component Updates:

Version 3.13.3

24 October 2020

Build 33081 — Download

(3.13.3 fixes a crash that happens only on macOS 10.13 High Sierra.)

NEW WebP Image Optimization

• WebP is a Google image format that's 50-70% smaller on disk than JPEG or PNG.
• CodeKit can now automatically export a WebP version of any PNG, JPEG, or GIF—even animated GIFs.
• Complete control over all 8,000 WebP Optimizer settings, neatly organized into "Presets".
• CodeKit adds WebP support system-wide, so you can view WebPs (ugh) in Finder and via QuickLook.
• Read the documentation or watch the screencast to get up to speed.

NEW Nova Extension

• Nova is a new NATIVE Mac editor by Panic.
• It does not suck.
• This extension automatically launches CodeKit and adds your Project to the app whenever you open it in Nova, saving you time and hassle.
• Install the Extension by downloading it or via Nova's Extension Library.
• I am slightly miffed that Nova's first-run screen is now cooler than mine. I will escalate this fight until GPUs set houses on fire, Panic.

Changed:

• The UI has been updated for Big Sur.
• The thumbnail at the top of the image inspector is now much more performant.
• The AppleScript API has a new method to refresh a Project.
• The core task-dispatching part of CodeKit is now written in Swift and builds got about 12% faster as a result.

Fixed:

• Certain textfields magically warped colors when edited in Dark Mode.
• An issue where a "Run Script" Build Step might not save its script source correctly.
• Edge didn't show up in the list of browsers because Microsoft changed its bundle identifier.
• An edge-case memory leak in the Sass import scanner.
• 3.13.2 fixes a bug in 3.13 where files set to "copy" would hang indefinitely and a bug where the "file-watching is paused" banner failed to show.

Gratuitously Unrelated

We started a podcast: Unmuzzled.fm

I'll give you one good reason to listen: there are ZERO Squarespace ads.

Component Updates:

Version 3.12.5

24 May 2020

Build 32186 — Download

Important:

Don't put off this update. It has a critical fix for some date shenanigans that will soon break the last version.

Fixed:

• An issue where your license might falsely show up as expired because ISO8601 dates are not RFC822 dates. Someone please just shoot me.
• An issue that caused Autoprefixer to ignore your custom Browserslist string.
• Jeet stopped working correctly when compiled with Libsass.
• Dart Sass deletes old CSS output files if it fails to compile your Sass. CodeKit now restores the old CSS so that your browser preview doesn't go full-stupid.

Component Updates:

Version 3.12.1

30 April 2020

Build 32147

3.12.1

Fixes a crash that could occur if your Sass files contain comments on the same line as @import.

NEW Dart Sass

Dart Sass is now the default Sass compiler in CodeKit.

• Existing projects that use Libsass won't automatically switch to Dart Sass.
• You can easily switch them manually. Open Project Settings > Languages > Sass and choose "Dart Sass" from the new "Compiler" pop-up button.
• Based on my testing, it's safe to switch compilers even for complex Sass. I recommend using Dart Sass because it gives you access to new features.

Some things to know:

• CodeKit now supports the new Sass module system, including @use and @forward. You MUST compile these files with Dart Sass. Libsass will completely ignore the directives and produce no errors, breaking your CSS.
• Dart Sass does NOT support import globbing at this time. Libsass does.
• Importing plain CSS files with @use is now supported. CodeKit will track the dependency and recompile your Sass file when the CSS file changes.
• Full details are available on this page.

Changed:

• Microsoft Edge is now available in the list of preview browsers, if it's installed.
• The option to create a new Compass project is gone. CodeKit will continue to compile legacy Compass projects just fine.
• The "Debug Style" option for Sass has been removed. Dart Sass does not support it and you should use Source Maps instead.

Fixed:

• An issue where @compile statements in Kit files could hang the app.
• Some drawing glitches on non-retina screens on Catalina.
• The global shortcut to pause file-watching broke in the last update. White House sources indicate the cause may be that I'm an idiot.
• The Components tab of the About window crashed on macOS 10.14.6.
• Autoprefixer broke if the IE Grid option was enabled. Listen, it has Internet Explorer right in the name. It might as well be called, "Does not work" or "Why yes, I would like to spend four hours on Stack Overflow and throw things this afternoon" or "Can I just do Coronavirus instead?"

Component Updates:

Version 3.11

6 April 2020

Build 32001

License Updates

CodeKit licenses come with 2 years of free updates. After that, you can renew your license for more updates. If you don't renew, any version of CodeKit released before your license expired keeps working forever.

• You can now see the expiration date in the About window, under "Registration". It will now also appear in the updater window.
• The license renewal page is now live.
• Since the world blew up, I've automatically extended every license that was set to expire earlier to 15 May 2020.
• I know paying for software is annoying. But without your help, we'll all have to figure out Webpack config files and I'll probably have to apologize to that Intuit recruiter who tried to get me to write TurboTax.

Firefox Bug

• Firefox has an intermittent bug that breaks injection browser-refreshing.
• It happens only if the Firefox web inspector is open and on the 'elements' tab.
• CodeKit now detects when the bug occurs and reloads the entire page to "reset" Firefox.
• Mozilla is aware of the issue. See this thread for details.

Fixed:

• Dropping files or folders on the Dock icon stopped working in Catalina. Like everything else in Catalina.
• npm failed to install devDependencies, even when set to do so.
• The Brave browser changed its bundleID, so it stopped showing up in CodeKit.

Achievements:

• Made it through the release notes without a single joke about social distancing.

Component Updates:

Version 3.10.2

20 October 2019

Build 31934

3.10.2 Changes

Rolls Libsass back to 3.6.1 until the Libsass team can fix some new bugs causing hangs during compiling. Removes the deprecated "Check For IE Compatibility" option for Less files, which caused compiling to fail.

NEW The Kit @Compile Statement

• Works like @import, but compiles the file first.
• Example: @compile 'someFile.md' will compile 'someFile.md' and drop the output in place.
• Works with any file CodeKit supports, including custom file types you add to the app.
• For details, watch this screencast or read the documentation.

NEW Image Comparison Tool

• You know how every fall all the blogs are like, "The Pixel 67 clearly takes better photos than the iPhone 24 Pro Max. I mean, just look at my child's hair by candlelight. LOOK AT MY CHILD! LOOK AT IT!"
• You know how those blogs have little sliders you can drag to compare the same photo from iPhone-whatsit and Android-dontcare?
• That's now in CodeKit:

• If your Project uses a Build Folder (so the image doesn't overwrite itself when optimizing), you can instantly compare the original and optimized versions. Select the file and hit the space bar or double-click the preview thumbnail in the Inspector.

Other New Stuff:

• Custom Environment Variables — Set them in the General section of Project Settings. They're available in all Hooks, Build Steps, and most of the tools CodeKit runs (including Babel, Rollup, etc.). See the documentation.
• Libsass Globbing — Sass globbing is now supported when using the Libsass compiler. (Even multi-level globbing.)
• Rollup Options — You can now specify external modules, enable/disable Treeshaking, and force string replacements when bundling. See the documentation.

Changed:

• PNGQuant is now multi-threaded and optimizes large PNGs faster.
• If you're still running macOS 10.11 or 10.12, you'll see a warning when CodeKit launches. Parts of the UI won't look right because of bugs in those ancient OS versions.

Fixed:

• Output Paths weren't editable sometimes because Swift is a pedantic ass.
• "Run Script" Build Steps sometimes failed if they appeared at the end of the Build process.
• Links to ESLint rules in the Log didn't work because Swift is a pedantic ass.
• Sass @debug statements weren't working due to a change in Libsass.
• ESLint wasn't working for some people in the original 3.10 release.

Major Component Updates:

Version 3.9.2

23 July 2019

Build 31491

Quick Fix

3.9.2 fixes issues where TypeScript files failed to compile and npm packages with names shorter than 4 characters didn't show up in search results.

NEW npm!

• The 'Components' area of CodeKit has been 100% rebuilt from scratch.
• It's WAY better. Faster, smoother, sexier. It's like Scarlett Johnasson, Ryan Reynolds, and Rachel McAdams had a sleepover with jQuery.
• This is the nicest thing anyone has ever said about jQuery.
• npm is now the default package manager.
• The old UI was terrible. I'd say I can't believe you put up with that garbage, but you've probably got Slack's app running right now, don't you?
• Bower is still fully supported. You can switch to it at any time, it uses the same new UI, and I even gave it new features. (Bower is deprecated by the developer, but it will be in CodeKit as long as it exists.)
• There are SO many new features: uninstalling, pruning, viewing changelogs in one click, breaking/non-breaking update warnings, custom endpoint installations, installing from a package.json file...
• Watch this 5-minute screencast to get up to speed fast. Or read the documentation.

NEW Notification Control

• You can now control exactly when CodeKit posts notifications, beeps, and comes to the front.
• See Preferences > Notifications
• It was not possible to migrate your old options to this new system.

Other New Stuff:

• Builds are 32% faster.
• The log design has been tweaked. (It's not the sexy sleepover that the new npm interface is, but it's not Gary Busey either.)
• Added the Babel UseBuiltIns and excludePaths options to the UI. (You can now control polyfills and transpile items in node_modules folders.)
• New project icons.
• The "Open With" menus now include Terminal as an option.
• You can now force CodeKit to always reload the entire page, even when just CSS files change. (Useful for Shopify developers.) See Project Settings > Browser Refreshing
• CodeKit is now notarized by Apple for security.

Changed:

• CodeKit now attempts to keep its window the same size. Previously, when you switched sections, the app restored the last known size for that section.
• CodeKit now supports full screen.
• Windows are now much more fluid when resizing/animating.
• Pages that do not have a <head> or <body> tag will now auto-refresh as long as they are HTML files.
• Previously, CodeKit would use up to 8 CPU cores during builds. If your Mac has more than that, CodeKit will now use them all.

Fixed:

• An issue where JS files with @codeKit statements wouldn't compile un-minified.
• An issue where the Project Icon Picker wouldn't display icons sometimes.
• An issue where browsers might hang and refuse to load the page if you switched the Preview Server from TLS to non-TLS.

macOS Catalina:

I don't officially support macOS betas, but folks tell me CodeKit is working fine on 10.15. This update is fully notarized and should be ready for Catalina.

Major Component Updates:

Version 3.8.2

27 February 2019

Build 29156

Hotfix

3.8.2 fixes a crash that occurred when scanning malformed Bower packages for import statements.

3.8.1 fixed an issue in 3.8 that caused crashes with the Projects Sidebar open.

NEW JavaScript Bundling

• CodeKit now supports using import statements to combine JavaScript files.
• Bundling is off by default. Turn it on with a single drop-down menu.
• See the documentation or watch the screencast for details.
• The older statements (//@codekit-prepend and //@codekit-append) are still supported. They will always be available for folks who don't want to (or can't) use ES6 Modules.

NEW HTML-Minifier

• CodeKit can now minify HTML files and anything that compiles to HTML (Kit, Markdown, Pug, etc.)
• To turn it on, just click the "minify" checkbox on your file.
• See the documentation for details.

NEW TerserJS

• CodeKit has a new JavaScript minifier!
• Terser supports ES6+ syntax. You no longer have to transpile code before minifying.
• Terser is a fork of UglifyJS (the old minifier), so all your settings carry over. There are some new ones. See the documentation for details.
• This update forces the comments option to OFF so that comments do not appear in minified files. Folks got tripped up by that in the last UglifyJS update.

Other New Stuff:

• New AppleScript API to get the status of the Preview Server and its URLs.
• New AppleScript API to get the active project's root path.
• When overriding remote CSS files with local copies, local source maps now override remote ones as well.
• Removed Google Web Starter Kit.

Changed:

• CodeKit now automatically scans node_modules and bower_components folders to match files to module names. This means you can just write import $ from "jquery" without providing a full path to the file to import.

Fixed:

• An issue in Kit files where @<!— was incorrectly interpreted as a variable name.
• An issue where the Skipped Items list could not be edited in New Project Defaults.
• An issue where textfields in Project Settings reset to default values when empty.
• An issue where textfield labels in the Registration window were invisible in Dark Mode.
• An issue where the title textfield in the Bower area always read "Wordgrapf Title"
• An issue where I just suck at textfields, apparently.
• An issue where the Project Icon sometimes reset during refreshes.
• Dragging collapsed Groups in the Projects Popover or Sidebar now works correctly.

IMPORTANT: The Future

Component Updates:

Version 3.7.4

9 October 2018

Build 28905

Sass & CSS

• The last update made it impossible to import CSS files into Sass files.
• The Sass team decided to roll back that change.
• This update restores the ability to @import CSS files. To have their content added to your Sass file, make sure your import statement does NOT include the .css extension.

Fixed:

• The browserslist label on the AutoPrefixer pane of Project Settings didn't update correctly.

Version 3.7.3

22 September 2018

Build 28901

3.7.3 Fixes:

• Babel source maps stopped working and enabling TLS could crash on Mojave.
• Remember when I said the new Content-Security-Policy headers "just work"? Turns out I meant that in more of the AirDrop sense: "60% of the time, it works every GODDAMMIT THE DEVICE IS RIGHT HERE WHY CAN'T YOU SEE IT IF I HAVE TO TOGGLE WIFI ON AND OFF ONE MORE TIME I'M BUYING A DELL I SWEAR."
• Anyway, CSP now works correctly. I promise.
• The rule editor in the Hooks area wouldn't save changes. That seemed inconvenient, so now it does.

3.7.1 Fixes:

• If Babel was enabled in the original 3.7 release, @codekit-prepend statements didn't work.
• If you were on macOS 10.11, the new Target Browsers pane crashed.

NEW Dark Mode + Mojave Support

• Dark mode is available on every version of macOS, not just Mojave.
• On 10.14+, CodeKit will match the system accent color by default, but you can set a different one if you prefer.
• Adopted Apple's new "runtime hardening" security. If the app is somehow ever compromised, this feature vastly limits what an attacker could access on your Mac.

NEW Target Browsers

• A new category in Project Settings: Target Browsers
• Shows all the desktop and mobile browsers in which your project will work.
• Shows coverage percentages for the world and your local region.
• Babel, Autoprefixer, and other tools will now automatically configure themselves based on what browsers you enter here.

NEW Babel 7

• No more configuring. Babel will automatically choose the right plugins based on the browsers you support.
• Much faster transpiling.
• If you previously customized Babel settings, double-check them after updating.

NEW Base64 Imports in Kit Files

• In Kit files, you can now write @import-base64 'someFile.png' to automatically base64-encode the target and include it in the base file.
• See the Kit documentation for examples.

NEW Less 3

Less has been updated to 3.8.1 and some options have changed (mostly about when math operations get performed). If you use Less, double-check the options on your files after updating.

More:

• The list of options for Syntax Checkers and UglifyJS is now searchable.
• When ESLint shows an issue in the Log, you can now click the rule name to instantly adjust that rule in Project Settings.
• New AppleScript command to process a single file at a time. See the docs.
• The Preview Server now supports Content Security Policy (CSP) headers. If your site uses them, they just work; there's nothing to configure.
• CodeKit now tracks@plugin directives in Less files and recompiles when they change.
• The PNG image optimizer is about 10% faster.

Fixed:

• If you add custom languages to the app, then swap extensions, settings don't get confused any more.
• An edge-case where the preview server could crash.
• A possible race-condition in browser syncing.
• Triple-slash directives in TypeScript files weren't handled correctly.
• CodeKit won't try to set up the refresh server on ancient browsers that can't handle it, which will make one guy stop emailing me.

Component Updates:

Version 3.6.1

10 April 2018

Build 26680

Take #2

• The people responsible for the original 3.6 release have been vigorously accelerated into the next plane of existence.
• This release solves that release's problems.
• The remaining people look highly motivated to get this one right.

Massively More Efficient

• CodeKit now uses 72% fewer CPU cycles to do the same amount of work. Better battery life, cooler laptops.
• All processing tasks are also 11% faster, on average.
• Folks still running macOS 10.12 get only part of the benefit, unfortunately. (See "Take #2", above.)

The Quiet Keyword

• You can now automatically silence warnings for imported JavaScript and CoffeeScript files using a keyword:
• //@codekit-prepend quiet 'jquery.js';
• (This is the same as unchecking the shield checkbox in the UI.)

Importing Skipped Items

• You can now use @codekit-prepend and @codekit-append statements to import any file on disk, even if it's in a Skipped Folder or outside of your project.
• If a file can't be found for one of these statements, you'll get an error in the log. Previously, no error was reported and CodeKit just ignored the special comment.

More Good Stuff

• The progress bar now shows actual progress and is far more accurate during builds.
• Builds can now be canceled.
• Found a couple things in the UI that were not flat. Flattened them with extreme prejudice.
• You can now choose "baseline" or "progressive" output formats for JPEG images.
• Removed silent "Export Data To Russia" feature. Apparently that's now frowned upon.

Project Icons

• Fact #1: CodeKit has always used "apple-touch-icon" images as your Project Icon, if the image exists in a standard location when you add the project.
• Fact #2: People put things in weird places.
• Fact #3: CodeKit will now, by god, find your image. 84 levels deep in a folder named "not_NOT_porn"? I got you.

Fixed:

• Optimizing JPEG files could discard their color profiles, causing them to look different.
• Some images could be corrupted during optimization.
• SVGO broke if a certain option was enabled.
• Text in log entries could sometimes display all over the place.

Component Updates:

Version 3.5.2

1 March 2018

Build 26330

NEW Sortable, Searchable Log

• You can now filter the log to show only errors and warnings.
• Log results are now searchable by path, project name, or text in the result message itself.
• The log automatically switches back to "All Results" when a new build starts so you don't miss anything.

Zurb Foundation Update

• New Foundation projects now use npm instead of Bower to install components.
• Legacy Bower-based projects continue to work just fine.
• The new process is way faster and cleaner.
• Fun Fact: If you install Foundation without CodeKit, you get 318 node modules taking up 141MB of space. WITH CodeKit, you need just 4 of those. The other 314 are dumpster fires of co-dependent JavaScript build tools.
• I guess they named Gulp after what it does to your disk space. Should have called it Sip.

Fixed:

• An issue where some SVGO options failed to work correctly.

Version 3.5.1

14 February 2018

Build 26268

Stuff And Things:

• Fixed: an issue introduced in the last update where the Kit language done got stupider.
• New: Autoprefixer option to add Internet Explorer prefixes for CSS Grid rules.
• Gitbox is now supported as a version control app for auto-pausing.
• You know who else updates CodeKit on Valentine's Day? Ryan Reynolds.

Version 3.5

28 January 2018

Build 26261

NEW Better TLS Support

• (TLS used to be called SSL. Hipsters decided too many people knew what it was, so new letters were required.)
• CodeKit previously supported TLS, but you would see warnings in your browser and it was finicky.
• This update provides TLS with no warnings. You even get the green lock icon in your URL bar.
• It's still just one click to enable, but you will need to send a certificate file to remote devices. Here's a quick screencast of how easy it is to do that.

Changed:

• If your project uses an External Server and its address ends in .dev but does not start with https:// you'll now get a warning.
• (Google owns .dev and every major browser is now hard-coded to FORCE https:// for that domain.)

Fixed:

• An issue where auto-pause stopped working if you switched between Terminal and a Git app.
• In Kit files, an issue where special comments immediately following an @ character did not work.
• Fixed Meltdown and Spectre because everybody else was doing it.
• There are now some limitations on what you can enter in the "Build Folder" textfield, because somebody typed the wrong thing and wiped out all his files.

Component Updates:

Version 3.4.2

10 November 2017

Build 26148

3.4.2

A few things came up after 3.4 shipped on 31 October, so this update replaces that one and fixes:

• An issue where the cache buster could crash on really short files.
• An issue where Hooks failed to run on macOS 10.13.
• Previewing in Blisk now actually previews in Blisk.
• An issue with TypeScript imports and infinite loops.
• An issue where syntax checkers hung.

NEW Cache-Busting

• Automatic cache-busting is now available for all files that compile to HTML, all generic file types, and all custom languages.
• It's smart. Caches are only busted when files have actually changed.
• It's fast. And by "fast" I mean "instantaneous-thank-god-some-of-us-still-know-C"
• Details: codekitapp.com/help/cache-buster/

NEW Auto-Pause File-watching

• File-watching is now automatically paused whenever a version control app becomes active (Tower, Cornerstone, the GitHub app, etc.)
• Optionally, you can also auto-pause file-watching when Terminal becomes active. To do so, choose CodeKit > Preferences from the menubar and check the box.
• And there was much rejoicing.

NEW CoffeeScript 2.0

• Fact 1: CoffeeScript now outputs ES2015, which means you'll need to transpile the output with Babel if you want to use it in a current browser.
• Fact 2: CodeKit has Babel.
• Fact 3: You don't need to do anything. There's a new "Transpile Output With" option for CoffeeScript files and it's automatically set to use Babel.
• Fact 4: If you've customized Babel's options in your project, you MAY need to adjust those to get the CoffeeScript output you expect. (Basically, the ES2015 Babel preset needs to enabled.)
• Fact 5: CodeKit just saved you, like, 3 hours of cursing and debugging a Gulp build script.

NEW MultiMarkdown 6.0

• The MultiMarkdown compiler has been updated to version 6.
• There are a few minor syntax tweaks, but it's unlikely you'll see any breaking changes.
• It's much faster.
• There's a whole host of new Output Formats available, including freaking eBooks. Seriously. You can now create an eBook complete with embedded images.

Changed:

• If you have a "generic" file with an Output Action of "Process" but have not added a Hook to DO any processing for that type of file, the file will now simply be copied to its output path. Previously, nothing happened to it.
• Clicking the "Files List" button when the Files List is already visible will now de-select all rows so that you can see the "Project Summary" pane again.
• Jeet 7.2.0 has a couple minor mixin changes that may break your Sass. See the Jeet website for details.

Fixed:

• A number of small drawing glitches on macOS 10.13 caused by the new Metal2 window server.
• Control-clicking a group name in the Projects Popover did not show the contextual menu.
• A rare edge case that could crash the app while scanning for @import statements in malformed files.
• A race condition in the Preview Server that could cause a crash.
• An issue where the CK_PROJECT_ROOT ENV variable was not set for "Run Script" Build Steps.
• An issue where I hadn't given Apple any money in a while.
• An issue where Bower may fail to install components with a 410 error.

Component Updates:

Version 3.3

17 August 2017

Build 25900

New:

• The browsers Blisk and Vivaldi now appear in the Preview menu if they're installed.
• CodeKit now recognizes the Transclude Base metadata tag in MultiMarkdown files and will use it to correctly link imported files.
• If you hold the Option key while launching the app, CodeKit now asks before resetting all data.

Susy 3:

• CodeKit now has Susy 3.0 built-in.
• 3.0 is the default version for all projects.
• For legacy Susy projects, switch back to version 2.0 in Project Settings > Frameworks > Susy.

Fixed:

• The SSL preview server is now working again in Chrome 59+. (It stopped working because Google changed their certificate parser.)
• An issue where trailing whitespace was incorrectly included as part of a variable value in Kit files.
• An issue where the Lannisters had an army.
• Slim files that import non-Slim files now show those links correctly.
• Custom Babel Presets now work correctly.
• An issue where Babel flipped out if the React node module is installed.
• If your Project folder contains a "." in its name, Output Paths were set incorrectly.
• ESLint options weren't applied correctly from New Project Defaults in some cases.

Patreon

So...I've set a crazy goal to take CodeKit open source and make it free. More people will use it, other developers can help me improve it faster, etc. But I still have to pay bills, so I'll need help before I can do that. If you like me or my work, please see patreon.com/bdkjones for details.

Component Updates:

Version 3.2

20 June 2017

Build 25849

NEW Local CSS Overrides

• You can now style and auto-refresh a website without hosting it locally.
• Great for complex sites that just HAVE to run on their live server.
• Watch this screencast for a quick walkthrough of how to use it.
• Whatever you do, however, do NOT watch this screencast.

Fixed:

• Issue where the "Preview Path Addition" option wasn't editable in Project Settings unless your project used an External Server.
• Issue where you hadn't seen the worst video on YouTube.

Component Updates:

Version 3.1

5 April 2017

Build 25813

NEW PNGQuant

• This is the new, default PNG image optimizer in CodeKit.
• 70% smaller PNG files with virtually NO loss of visual quality.
• It's black magic. There's chanting involved. Virgins died. Souls were sold. (Mostly Kardashian souls though, so don't feel guilty.)
• While this is technically a "lossy" optimizer, it's the default one because it's THAT good. Trust me. Just re-optimize all your images.
• PNGQuant is written by Kornel Lesiński, the developer behind the fantastic Mac App, ImageOptim. He was kind enough to sell me a commercial license for the algorithm.
• See the PNG Help Page or the screencast narrated by Morgan Freeman for a walkthrough of the options.
• The old, lossless PNG optimizer (OptiPNG) is still available, if needed. See the docs for why you might use it on some images.
• I'm kidding, of course. Kardashians don't have souls.

Data Migration

If you saw a bouncing Dock icon during the last update, that was due to data migration. (When I add new options, the app has to apply them to existing items before it can run.) A little window was supposed to pop up with a message. It didn't. It does now. The migration process is also 85% faster.

Fixed:

• The preview server incorrectly added trailing slashes after URL query parameters in certain cases.
• Neat's main stylesheet was missing when you installed Neat in your project.
• Copying links by right-clicking "Documentation" buttons did not work.
• The "trial days remaining" banner did not disappear if you entered your license information manually instead of using the button in the license email.
• Projects set to auto-build newly-added items will no longer build those when the app first starts up. Items will only auto-build if CodeKit is running and watching the project in question when they are added.

Component Updates:

Version 3.0.8

10 March 2017

Build 25704

NEW Lossy JPEG Optimization

• There's a slider in Project Settings > Languages > JPEG that lets you reduce image quality to get smaller JPEG files.
• You can also set quality on a file-by-file basis by selecting only JPEGs and using the right-hand Inspector panel.
• Remember: modern image editors are already *really* good at writing small files, so your gains may vary.

Libsass Improvements

• Me: "Oh come on, you can't write a Sass file so complex it would cause a stack overflow in Libsass."
• You: "Hold my beer."

It is now literally impossible for an issue in Libsass to crash CodeKit. Malformed Sass files that previously crashed the app will now show correct error messages.

Libsass now runs as a completely separate process (codekit-libsass-service in Activity Monitor). The first Sass file you compile will take about one second longer while this process launches. All Sass files after that will compile without delay.

Neat 2.0

The built-in version of Neat has been upgraded to 2.0. You'll need to tweak a few things in your Sass files to use it. See this page for 1.8->2.0 changes.

Fixed:

• An issue where JPEG images sometimes failed to optimize.
• An issue in the 3.0.7 update that caused Sass compiling to fail on old versions of macOS.

Component Updates:

Version 3.0.6

22 February 2017

Build 25568

New:

• By popular demand, the dock and menubar icons now show a "paused" symbol when CodeKit's file-watching is...wait for it...paused.
• You can now right-click the Dock icon to pause/resume file-watching.
• Libsass has gained support for @warn and @debug statements. You'll see them in the log when appropriate.
• Sorting Bower components by stars now starts with the components that have the most stars instead of the least.

Fixed:

• An issue where include statements in Slim files failed.
• An issue where browsers were sometimes unnecessarily refreshed twice.
• If you closed the New Project Defaults area while a text field was still editing, the new value wasn't saved. It now is.
• An issue where Susy did not work correctly with the Libsass compiler because I forgot a colon in a string. No, really; one colon. This is why developers drink.
• An issue where Compass reported (null) for error messages instead of the actual error message.
• For a variety of dubious technical reasons, the Browser Refresh Delay value is now limited to integers between one and six seconds.

Component Updates:

Version 3.0.5

17 January 2017

Build 25504

Fixed:

• An issue where Slim files compiled into nonsense.
• An issue where variables in Kit files that started with capital 'A' through capital 'N' were not detected correctly. The issue was addressed by sending the people who began variable names with capital letters to re-education camps.
• An issue that caused CodeKit to rewrite URLs in assets other than webpages (such as JS files) when using an external server.
• An issue where Mariah Carey still had a career. The issue was addressed through additional public humiliation.

New:

• Hooks can use a new environment variable to access the current project's root folder: $CK_PROJECT_ROOT. This is in preparation for a big new feature in the next release.
• #teasing #stillnotanewmacpro

Jeet 7

Jeet is being maintained again! This release includes Jeet 7, which has a few breaking changes. Read the migration guide. (Ignore the crap about updating import statements though. You use CodeKit, so just write @import 'jeet'; and go.)

Component Updates:

Version 3.0.4

14 December 2016

Build 25479

Fixed:

• SVGO options were not applied correctly, causing SVGs to not optimize correctly.
• Text in the log mangled itself when selected.
• An issue where changes to an output file did not trigger re-compiling of files that import that output file.
• A rare memory corruption issue when restarting the preview server.
• An error when using Slim's "logicless" mode.
• An issue where Autoprefixer and Bless options from Project Settings weren't applied correctly to stylesheet files.
• JS files that are set to not minify or transpile now get written to their output path as-is when processed.
• Entries in a "Process Items" build step now maintain their order to avoid Git conflicts in the config.codekit3 file.
• An issue where the world was likely to prosper for the next four years.

Component Updates:

Version 3.0.3

3 November 2016

Build 25444

Bourbon 5:

• This update includes Bourbon 5.0.0 Beta 7
• Some mixins have been removed, some have been updated. You may need to tweak your Sass. For details, see the Bourbon Changelog.

Fixed:

• An issue where installing Bitters files failed because CodeKit was being dumb.
• An issue where SVG optimization silently failed if the output folder did not exist.
• Enabling WordPress debugging mode no longer puts your browser into a reload loop.
• A small memory leak in the Kit compiler
• An issue where I almost went three days without releasing an update.

Component Updates:

Version 3.0.2

1 November 2016

Build 25428

New Features:

• If you select a folder that is NOT skipped, you can now set the Output Action for all items in and below that folder at once.
• Useful if, for example, you want to set everything in bower_components to "ignore", but don't want to skip the folder so that you can still do things like prepend JS files that are in that folder.

Trailing Slash Behavior:

• If you type an address in your browser like http://vdk.local:5757/subfolder and omit the trailing slash, CodeKit will now redirect the browser to the URL with a trailing slash.
• This happens as long as the directory you requested (here, "subfolder") actually exists. If it does not, the server returns a 404. (Because you *could* be requesting a file that has no extension, so the server can't assume that the resource you requested is supposed to be a directory.)

Fixed:

• Custom Bower Favorites weren't loaded correctly.
• Code pasted into a Hook or Build Script textView did not save correctly.
• If you added a "Preview Start Path" in Project Settings, the non-Bonjour server address incorrectly showed the Bonjour address.
• An issue where the developer of CodeKit was not caught up on The Walking Dead.
• Scanning CoffeeScript files with CoffeeLint produced a crash. Ain't nobody got time for that nonsense.
• JSHint options got cut off in Project Settings.
• .codekit-cache folders no longer show up in the files list.
• The search field in the files list Scope Popover did not clear correctly in some cases.
• Fixed a few outdated option strings for ESLint options.
• Three beta testers were sacrificed to Ba'al, The Soul-Eater. This was done to ward off future bugs, but since none of them were virgins, Ba'al was displeased. I would back up your Mac.

Component Updates:

Version 3.0.1

29 October 2016

Build 25390

Apple and I released new stuff together. There were a couple bugs in CodeKit, so that's a point for Apple. But...you don't have to take out a second mortgage on your house to buy dongles when you upgrade to CodeKit 3. So that's a point for CodeKit. See you at WWDC, Schiller.

New Features:

• Hidden items like .htaccess files now appear in the list so they can be processed/copied on build.
• Menu command and keyboard shortcut to open the Build area: cmd+5

Fixed:

• An issue where New Project Defaults were not applied correctly for syntax checkers, UglifyJS and Babel.
• An issue where default output path options were not saved correctly for the Kit language.
• Files that do not have an extension no longer have a dangling period at the end of their output paths.
• The link to Haml's documentation was incorrect.
• An issue where extra newlines were added to a JS file in certain cases.
• An issue where a log message could be blank if a file was processed but there was nothing to do.
• An issue where none of my 80 beta testers caught any of this stuff and were allowed to retain full use of their legs.

Version 3.0

26 October 2016

Build 25378

Is It Perfect?

Nope. I'm sure there are some bugs that got past the beta.

Is It Going To Explode And Set A Plane On Fire?

No. The bar for success has really been lowered.

Version 2.9.1

20 October 2016

Build 19142 — Download

What's New

This update adds a few things that will enable a seamless migration to CodeKit 3, which is launching next week. Skipping or procrastinating on this update is a poor life decision.

Version 2.8

10 May 2016

Build 19127

New

• Safari Technology Preview is now an option for the Preview Browser.
• Hired Ramsay Bolton to deliver my totally constructive, friendly, and 100% positive feedback to Apple Developer Relations.

TypeScript

You may need to change the Output Module type for your TypeScript files from CommonJS to System after this update, due to a change in the TypeScript compiler.