Harlowe's French Dip: The Ultimate Savory Sandwich Sensation

Harlowe's French Dip delivers a cinematic flavor with café-style richness baked directly into the Twine story format. This guide explores how the format choice shapes pacing, immersion, and readability for interactive fiction writers.

Whether you are new to Twine or refining a narrative style, understanding Harlowe's specific behaviors helps you align mechanics with creative intent. The sections below break down core concepts with structured references you can scan quickly.

Aspect	Description	Impact on Storytelling	Best Practice
Story Format	Harlowe 3.x with the default story metadata	Determines built-in macros, variable handling, and default UI	Declare format version early in the story title screen
Variable Scope	Local, temporary, and global variables	Controls persistence across passages and memory of choices	Use temporary variables for short-term UI state, global for save-game data
Passage Rendering	How passages are inserted into the DOM when visited	Influences animation, scroll behavior, and CSS styling	Keep passage content modular and avoid large blocks of static text
Macro System	Built-in and custom macros for automation	Reduces repetition and centralizes complex logic	Document custom macros with comments and version tags

How Harlowe Handles State

Variable Management

Harlowe relies on a straightforward variable system where numbers, text, and lists can be updated as the reader progresses. Temporary variables are cleared when the story restarts, while global variables persist through saves, making them ideal for tracking flags like relationships or unlocked areas.

Data Containers and Stories

You can store structured data in story variables and retrieve it with a simple story query. This approach supports dynamic scenes where statistics, inventory, or relationship scores adjust in response to reader choices without complex scripting.

The way passages link together directly affects pacing and clarity. Harlowe encourages concise passages with clear exits, so readers always know how each decision moves the story forward.

Structuring Flow

Using consistent naming and section breaks keeps your project manageable. Group related passages into fragments, and plan major turning points on a flowchart before implementing them in the editor.

Advanced Interaction Patterns

Complex scenes become easier when you break them into small, reusable elements. Combining simple macros with well-named variables allows you to create branching puzzles, timed choices, and resource management without overwhelming your reader.

Timing and Conditions

You can gate content behind conditions based on variables, then reveal alternate lines or entire passages. This pattern is especially useful for tracking achievements, sanity meters, or shifting alliances across multiple playthroughs.

Getting the Most from Harlowe's French Dip

Define variable naming conventions early to keep logic readable
Use temporary variables for UI state and global variables for save data
Break complex scenes into small, testable passage fragments
Document custom macros and core story rules in a single guide
Test choice chains frequently to catch unintended story locks

FAQ

Reader questions

How do I change the style of my passages in Harlowe?

Modify the story's CSS stylesheet or use the (stylesheet:) macro to adjust fonts, colors, and layout directly from your passage templates.

Can I save custom variables between play sessions?

Yes, global variables are preserved when you save the story, so you can track persistent state like chosen allegiances or unlocked items across sessions.

What is the safest way to reuse passage content across the story?

Create custom macros or use the (include:) macro to pull in shared text blocks, ensuring updates propagate consistently wherever they appear.

How does Harlowe handle undo and history navigation?

Harlowe automatically records passage visits and variable states, allowing reliable undo and back-button behavior without extra configuration.