sammyai

Sammy - AI Figma to JIRA Story Creator

Overview

Sammy is your AI-powered companion that turns Figma designs into detailed JIRA stories. With a beautiful UI and smart platform detection, Sammy helps bridge the gap between design and development.

🚀 Chrome Web Store: Coming Soon - Currently in review

🎥 See Sammy in Action

Watch a quick demo of how Sammy works: View Demo on Loom

Value Proposition

• Save 5+ minutes per story - Automated story generation from Figma designs
• Zero hallucinations - Combines AI vision with actual Figma layer data
• Platform-specific tickets - Automatically creates separate iOS, Android, Web, and API stories
• Perfect for teams - Ideal for product teams that live in Figma and JIRA

Setup Instructions

1. Install the Extension

1. Open Chrome and go to chrome://extensions/
2. Enable “Developer mode” (top right)
3. Click “Load unpacked”
4. Select the sammy-simple folder

2. Configure API Keys

1. Click the extension icon in Chrome
2. Click “Open Settings” or right-click the extension and select “Options”
3. Enter your credentials:
   • OpenAI API Key: Get from https://platform.openai.com/api-keys
   • JIRA Domain: Your Atlassian domain (e.g., yourcompany.atlassian.net)
   • JIRA Email: Your Atlassian account email
   • JIRA API Token: Create at https://id.atlassian.com/manage-profile/security/api-tokens
   • Project Key: The JIRA project where stories will be created
4. Click “Save Settings”
5. Click “Test Connection” to verify everything works

3. Using the Extension

1. Open any Figma design file
2. Press and hold Alt to show Sammy
3. Click to place Sammy where you want to analyze
4. Optionally add context about your design
5. Review the generated story:
   • Edit title, description, and acceptance criteria
   • Select target platforms (iOS, Android, Web, API)
6. Click “Create JIRA Tickets” to create stories for selected platforms

Features

Smart Platform Selection

• Choose any combination of platforms:
  • 📱 iOS
  • 🤖 Android
  • 🌐 Web
  • ⚙️ API
• Automatically prefixes tickets with platform tags
• Creates separate tickets for better tracking

Interactive Story Editor

• Edit any part of the generated story
• Live preview of changes
• Rich text editing for acceptance criteria
• Context-aware story generation

Beautiful UI

• Smooth animations and transitions
• Platform-specific emoji indicators
• Clear visual feedback
• Modern, clean design

For Production Use

Replace Mock with Real APIs

1. In background.js, replace with background-prod.js:

   cp background-prod.js background.js
   

Security Notes

• API keys are stored in Chrome’s secure sync storage
• Never commit API keys to version control
• Consider implementing additional encryption for sensitive data

Troubleshooting

Canvas capture is empty

• Make sure you’re viewing a design in Figma
• Try zooming in/out to ensure content is visible
• Check that you’ve selected a frame or component

API errors

• Check your API keys in settings
• Ensure you have credits/access for OpenAI
• Verify JIRA permissions for creating issues

JIRA creation fails

• Check that the project key exists
• Ensure your API token has write permissions
• Verify the issue type “Story” exists in your project
• Make sure at least one platform is selected

Pricing & Monetization

Planned Pricing Models

1. Freemium - 20 free stories/month, then $10/seat/month
2. Team License - $999/year for 100 seats
3. Usage-based - $0.25 per story generated

Why Sammy is Worth It

• Time Saved: ~5 minutes per story × 400 stories/year = 33 hours saved
• Quality: Structured data from Figma prevents AI hallucinations
• Consistency: Every story follows the same high-quality format
• Platform Support: Automatic platform-specific ticket creation

For Developers

Building for Production

1. Replace mock APIs with production endpoints
2. Ensure all API keys are properly secured
3. Test with real Figma designs and JIRA instances
4. Submit to Chrome Web Store

Contributing

PRs welcome! Please ensure all tests pass and follow the existing code style.

Privacy & Security

• API keys stored locally in Chrome’s secure storage
• No data sent to third-party servers (only OpenAI, Figma, and your JIRA)
• Open source for transparency

Support

• Issues: GitHub Issues
• Email: jordancoinjackson@gmail.com
• Documentation: See CLAUDE.md for technical details