Tumblr SASS building kit
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.




It takes a SASS file (or series of @imported files) and sticks it inline in a Tumblr HTML theme. It's intended for manging several (3+) Tumblr blog themes, or just having a build process that pairs Tumblr themes with SASS.

Specifically, it:

  • Builds a SASS file and puts it inside a <style type="text/css"></style> tag
  • Allows for Tumblr theme variables in the SASS files, which parse into <meta name="color:Heading text" content=""/> style meta tags and #title{color: {color:Heading text} } style template strings


Do some setup (requires git, python, pip)

$ git clone http://github.com/LynnCo/TumblrDevKit.git
$ cd TumblrDevKit
$ pip install -r requirements.txt

Create some HTML (example)

$ subl static/themes/BLOGNAME.sass

Create some SASS (example)

$ subl static/sass/BLOGNAME.sass

Run the script

$ python scripts/main.py

    Creating theme for blog BLOGNAME


    Built theme:
    Customize URL:

Copy paste the built theme view-source:file:////... address in your browser, or open that file in a text editor. It won't require any more edits before being pasted into Tumblr. Also the filepath doesn't change between builds, so just reload the page to get new versions.

Tumblr Variables in your SASS

You can format your SASS variables to be Tumblr theme customization variables (editable in the theme customization interface). The format for that is


In BLOGNAME.sass it will look like this

$color_primary: unquote("{color:primary}")
$color_primary: rgb(244, 231, 144) !default

$font_title: unquote("{font:title}")
$font_title: Montserrat, "Helvetica Neue", Helvetica, Arial, sans-serif !default

Note that the variables have to be inside of BLOGNAME.sass, not imported from another file. The active branch has in use examples.

The format is fairly fragile, so the script will tell you when you get it right / wrong

Random Stuff

  • The SASS builder adds {CustomCSS} to the end of your style block
  • The intent of this tool is entirely SASS integration, so it doesn't change your HTML theme - except to add the CSS / meta tags of course.
  • This tool used to parse Tumblr themes into Jinja2 themes, then rendered them with a local Flask server. This allowed working on themes while entirely offline, but in the end that feature was more work than it was worth.
  • Similarly, it used to deploy to Tumblr from command line, but Selenium turned out to be a very poor tool for that purpose.
  • I really want to hear about it if you used this!!!