A downloadable tutorial set

Download NowName your own price

The Twine Grimoire is an unofficial introduction to using CSS and HTML to customize the appearance and behavior of projects made in Twine® 2! This first volume is an 84 page, 100% free PDF which contains 6 detailed tutorials on:

  • Installation & Getting Started
  • Text Styling
  • Link Styling
  • Customizing Passages
  • Customizing Backgrounds
  • Embedding Images


Each section discusses both SugarCube and Harlowe Story Formats, with emphasis on the most recent versions.

Other features discussed include: tag-based styling, using the CSS Stylesheet, usage of macros and named hooks in Harlowe, how to organize your files, and other topics. There are screenshots and examples of code provided throughout each tutorial.

The aim of this project is to demonstrate how CSS and HTML can be used in a variety of Twine 2 Story Formats as a method of fine-tuning a game’s visuals. The information in these tutorials is not compatible with previous versions of Twine such as Twine 1.4.2. These tutorials are suitable for beginner to intermediate users, and this first volume is geared toward common features that many first-time users are interested in working into their projects.

Other helpful resources:

More resources, including links to Story Format documentation, can be found in the PDF.


Thank you to all of my patrons whose support made it possible for me to take the time to write these tutorials, revise them, and compile them into a single free PDF! Thank you also to @videlais for his work on the Twine Cookbook, to which I've had the pleasure of contributing, Ken Alba for his support and interest in my tutorials as an educator, and especially @klembot for creating Twine!

In the interest of making this resource as accessible as possible to many users, the Grimoire will never have a minimum donation required to download.

About Twine:

Twine® is an “an open-source tool for telling interactive, non-linear stories” originally created by Chris Klimas in 2009; it is now maintained by “a whole bunch of people at several different repositories,” per Twinery.org. I am in no way affiliated with its development process. Twine is also a registered trademark of the Interactive Fiction Technology Foundation.

Rated 4.9 out of 5 stars
(51 total ratings)
AuthorGrim Baccaris
Tagsbook, Game Design, pdf, resources, Tutorial, tutorials, Twine
Average sessionAbout an hour


Download NowName your own price

Click download now to get access to the following files:

The Twine Grimoire Vol 1.pdf 3 MB

Development log


Log in with itch.io to leave a comment.

Thank you so much for making & sharing this incredible resource!


for someone like me, whos wanted to make stuff in twine for a while and , fruitlessly attempted to make something before, this is really helpful. so, thank you. i hope i make something soon with this newfound knowledge hehe


Ahhh this is really helpful!!! I was able to understand Twine quickly :) Thanks a bunch!


Thank YOU, I'm so happy to hear that! Wishing you the best with your future Twine projects!


Is this still compatible with the most recent twine version?

Yes, thanks for asking! Though there have been updates since this was first published, you can still follow these tutorials with both current versions of the SugarCube and Harlowe formats. This was published before the latest Harlowe update, so it doesn't cover the new toolbar that may simplify some aspects of these tutorials (like changing text colors and background colors in specific passages), but the information in this PDF should still be usable.


This is very helpful! I'm sure I'll learn a lot of things from this! Thank you!

I'm so happy to hear that! Thank YOU.

(1 edit) (+1)

Hi, thanks a lot for this! Really looking forward to starting with Twine with this. Gave on Patreon as I don't use Paypal either.

Thank you so much for your support! I hope this will be helpful for you as you're getting started; let my know if you have any questions as you're working through it!


Really nice work on the Grimoire. Thanks for including instructions for Harlowe! Gave at Patreon instead of here, since I don't use PayPal. Peace.

Thank you so much for the kind words and for your support! Really glad you found the Grimoire helpful.


YAY! Been looking forward to this for a while now! Thank you for sharing your knowledge!!

It's my pleasure!! So excited to hear you were looking forward to it!


Yess!!!! Thank you!! I'm gonna the read the shit out of this!!! <3

Thank YOU!!! I'm so happy this is useful to people!