Squiffy

Squiffy is a tool for creating interactive fiction - that is, multiple choice games that focus on text and story. Players navigate through the game or story by clicking links.

Squiffy is free and open source. It creates HTML and JavaScript, so you can upload it to your own website, or to a site like textadventures.co.uk or itch.io.

A player’s state is automatically saved to their browser’s local storage, so they can always pick up from where they left off just by going back to the same web page.

The Squiffy Editor runs entirely in your browser. All your data is saved locally on your device, automatically.

Using Squiffy

You can find Squiffy at app.squiffystory.com.

Example

This documentation features editable examples. Edit the example on the left, and play it on the right.

99

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

›

Squiffy is a tool for creating interactive stories.

You write your story in a text file. Each choice is represented by a [[new section]]. You can create links to new sections by surrounding them in double square brackets.

[[new section]]:

In addition to sections, Squiffy has the concept of passages. These are sections of text that don't advance the story. For example, you can click this [passage link], and this [other passage link], but the story won't advance until you click this [[section link]].

[passage link]:

This is the text for the first passage link.

[other passage link]:

This is the text for the second passage link.

[[section link]]:

When a new section appears, any unclicked passage links from the previous section are disabled.

Restart

Publishing your game

Squiffy creates HTML, CSS and JavaScript files, which you can upload anywhere. You don’t need to distribute your source .squiffy file - everything that is needed for the game to run is contained in the HTML and JavaScript.

If you’re using the web version, just hit the Publish button to share your game on textadventures.co.uk. You can also choose “Export HTML and JavaScript” from the Download menu, which will give you a ZIP file you can upload to any website.

If you’re using the app for Windows, MacOS or Linux, hit the Build button to create the HTML, CSS and JavaScript files in the same directory as the game file. This will also open the results in your web browser for you to preview.

Contributing

Squiffy GitHub repository

If you find a bug, please log an issue.

You can discuss Squiffy on Discord, at GitHub Discussions, or at infiction.org (using the squiffy tag).