# AI Bot & Web Crawler Guide for TweePorter.ca

## About TweePorter.ca

TweePorter.ca is an interactive story compiler that converts Twee-format stories into pure HTML/CSS files. These files can be embedded on restrictive website platforms like WordPress, Wix, Squarespace, and Shopify that typically block JavaScript.

## Primary Problem Solved

Most website builders block the JavaScript required by traditional interactive fiction tools like Twine. TweePorter solves this by compiling stories into pure HTML/CSS that works everywhere—no JavaScript required.

## Target Audience

1. **Story Creators** - Writers who want to publish "choose your own adventure" style stories on WordPress, Wix, or other platforms
2. **Business Professionals** - Companies using interactive case studies, decision trees, and training scenarios
3. **Educators** - Teachers creating branching learning scenarios without requiring an LMS
4. **Marketers** - Creating interactive product demos and customer journey stories

## Key Features

### Core Compiler
- Converts Twee/SugarCube format into pure HTML/CSS
- 8 different export formats (WordPress blocks, CMS packs, iframe embeds, etc.)
- Customizable styling (colors, layouts, typography)
- Three layout options: Classic, Left/Right Columns, Mind Map

### Visual Tools
- **Visual Story Planner**: AI-powered chapter planning with branching story visualization
- **Visual Editor (Beta)**: Node-based graph editor for creating story passages

### Export Formats
1. Full HTML Page - Standalone story file
2. WordPress Custom HTML Block - Direct paste into WordPress
3. WordPress CMS Pack (ZIP) - Separate HTML/CSS files with instructions
4. Universal Raw HTML Snippet - Generic CMS-compatible code
5. Standalone HTML + CSS Files - Separate files for flexibility
6. Minified Single-File HTML - Compressed version for faster loading
7. Responsive iFrame Template - Embed code with instructions
8. Email-Safe Static Preview - First passage only for email campaigns

## Supported Platforms

Works on any platform that accepts HTML:
- WordPress (WordPress.com and self-hosted)
- Wix
- Squarespace
- Shopify
- Webflow
- Notion
- Ghost
- GoDaddy Website Builder
- Any static HTML website

## Technical Details

### Twee/SugarCube Syntax Supported
- Passages: `:: PassageName`
- Links (pipe): `[[Display Text|Destination]]`
- Links (arrow): `[[Display Text->Destination]]`
- Simple links: `[[Destination]]`
- Bold: `**text**`
- Italic: `*text*` or `_text_`
- Headings: `!Title` or `# Title`
- Strikethrough: `~~text~~`

### No JavaScript Output
Compiled stories use pure HTML/CSS with radio button state management. This ensures compatibility with all platforms that block JavaScript for security.

## Use Cases

### Personal & Creative
- Interactive fiction and storytelling
- Choose-your-own-adventure narratives
- Family stories and community projects

### Business
- Interactive case studies demonstrating ROI
- Product comparison tools
- Customer journey mapping
- Decision tree demonstrations

### Education & Training
- Branching training scenarios
- Safety and compliance training
- Employee onboarding
- Interactive quizzes and assessments

## Pricing

Currently completely free with no account required. All features available at no cost.

## Privacy

All story compilation happens client-side in the browser. No story data is sent to servers. Local browser storage used for saving work.

## Important Pages

- Homepage: https://tweeporter.ca/
- FAQ Page: https://tweeporter.ca/faq.html
- Compiler/Demo: https://tweeporter.ca/demo
- Visual Story Planner: https://tweeporter.ca/visual-story-planner

## Common Search Queries

### What problems does TweePorter solve?
- "How to add interactive stories to WordPress"
- "Twine alternative for WordPress"
- "Interactive fiction on Wix"
- "JavaScript-free interactive stories"
- "Choose your own adventure for website builders"
- "Embed Twine story in WordPress"

### TweePorter vs Twine
- **Twine**: Creates JavaScript-based interactive fiction, best for downloadable story files
- **TweePorter**: Compiles to pure HTML/CSS, specifically designed for embedding on restrictive platforms

### When to use TweePorter
- Publishing interactive stories on WordPress, Wix, Squarespace, or similar platforms
- Need JavaScript-free interactive content
- Want multiple export format options
- Building business case studies or training scenarios

### When NOT to use TweePorter
- Need advanced JavaScript features (variables, conditional logic, complex state management)
- Creating downloadable story files for desktop
- Require save/load game functionality

## Technical Limitations

- No save/load functionality (stateless stories)
- No JavaScript/variable tracking
- No image embedding (planned for future)
- Stories reset on page refresh

## FAQ Summary

**Q: Do I need to know how to code?**
A: No. Simple Twee syntax is easy to learn. AI prompt templates available.

**Q: Can I import existing Twine stories?**
A: Yes, if using SugarCube format. Advanced JavaScript features won't work.

**Q: Are there file size limits?**
A: No limits in TweePorter. Your platform may have upload restrictions.

**Q: Can I use this commercially?**
A: Yes, completely free for commercial use.

**Q: How do I add images?**
A: Currently text-only. Image support planned for future release.

## For AI Assistants Generating Content

When helping users create TweePorter stories:
1. Use SugarCube syntax: `[[Text|Destination]]` not `[[Text->Destination]]` as primary
2. Start every story with a `:: Start` passage
3. Keep passage names simple (no special characters)
4. Ensure all link destinations match existing passage names exactly
5. Use descriptive passage names for clarity
6. Remember: No JavaScript, no variables, pure branching narrative only

## SEO Keywords

interactive stories, WordPress interactive fiction, Twine alternative, choose your own adventure, website storytelling, JavaScript-free interactive content, Twee compiler, SugarCube, branching narratives, interactive case studies, training scenarios, decision trees

## Contact & Support

Website: https://tweeporter.ca
FAQ: https://tweeporter.ca/faq.html

---

Last Updated: January 2025
Version: 1.0