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 Kilmas 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.


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.


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!