Tickets are the heart of TurtleApps. They're how you tell AI what to build. This guide shows you how to create effective tickets that produce great results.

Creating a Ticket

Open Ticket Creator

In your project, click "New Ticket" or use the keyboard shortcut N. You can also use Ctrl/Cmd + K and type "new ticket".

Write Your Description

Describe what you want to build in natural language. Be specific and include relevant details.

Ticket creation form

[Screenshot placeholder]

Add Attachments (Optional)

Upload screenshots, mockups, or documents to provide visual context.

Submit for Review

Click "Submit" to send your ticket to AI for analysis and planning.

Writing Effective Descriptions

Good vs. Bad Descriptions

❌ Bad: "Add a form"

✅ Good: "Add a contact form to the /contact page with:
- Name field (required, min 2 characters)
- Email field (required, must be valid email)
- Subject dropdown with options: General, Support, Sales
- Message textarea (required, min 20 characters)
- Submit button that shows loading state
- Success toast on submit
- Error handling for failed submissions
- Form clears after successful submit"

Include Context

Context:
- This is for our B2B SaaS landing page
- Should match the existing design system (Tailwind + shadcn/ui)
- Form submissions should go to our existing /api/contact endpoint
- Use react-hook-form for validation

✨Reference Existing Code

Tell AI to follow existing patterns: "Use the same card component from the pricing page" or "Follow the form validation pattern from the signup page".

Ticket Templates

Use templates for common ticket types:

Feature Request

**Feature:** [Name]

**Description:**
[What the feature does]

**User Story:**
As a [user type], I want to [action] so that [benefit].

**Acceptance Criteria:**
- [ ] Criterion 1
- [ ] Criterion 2
- [ ] Criterion 3

**Technical Notes:**
[Any technical requirements or constraints]

Bug Fix

**Bug:** [Title]

**Current Behavior:**
[What happens now]

**Expected Behavior:**
[What should happen]

**Steps to Reproduce:**
1. Step 1
2. Step 2
3. Step 3

**Additional Context:**
[Screenshots, error messages, etc.]

Ticket Limits

Ticket limits depend on your plan:

Starter — 5 AI tickets/month
Professional — 50 AI tickets/month
Business — 200 AI tickets/month
Enterprise — Unlimited

💡Ticket Credits

Simple tickets use fewer credits than complex ones. Bug fixes typically cost less than new features.

Tickets Aanmaken