ispect_jira 4.2.0

An additional package for ISpect to create Jira tickets

Jira ticket creation integration for ISpect debugging toolkit

🔍 Overview

ISpect Jira provides seamless integration between ISpect debugging toolkit and Jira for automated bug reporting and ticket creation.

🎫 Ticket Creation • 📸 Screenshots • 📝 Context • 🔧 Configuration

Streamline your bug reporting workflow by automatically creating detailed Jira tickets with screenshots, device information, and debugging context directly from your Flutter app during development and testing.

🎯 Key Features

• 🎫 Automated Ticket Creation: Create Jira tickets directly from the debugging interface
• 📸 Screenshot Attachment: Automatically attach screenshots to tickets
• 📝 Context Collection: Gather device info, logs, and app state for tickets
• 🔧 Configurable Fields: Customize ticket fields and metadata
• 🚀 Easy Integration: Simple setup with existing Jira instances
• 🎛️ Flexible Auth: Support for various Jira authentication methods

🔧 Configuration Options

Basic Setup

void main() {
  final iSpectify = ISpectifyFlutter.init();

  ISpect.run(
    () => runApp(MyApp()),
    logger: iSpectify,
  );
}

class MyApp extends StatefulWidget {
  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    // Initialize with your Jira credentials
    ISpectJiraClient.initialize(
      projectDomain: 'your-company',  // your-company.atlassian.net
      userEmail: '[e-mail]',
      apiToken: 'ATATT3xFfGF0...', // Generate from Jira API tokens
      projectId: '10007',
      projectKey: 'MOBILE',
    );
  }
}

Authentication Methods

// Method 1: Direct initialization in code
ISpectJiraClient.initialize(
  projectDomain: 'your-domain',
  userEmail: '[e-mail]',
  apiToken: 'your-api-token',
  projectId: '10007',
  projectKey: 'PROJECT',
);

// Method 2: Runtime authentication with UI
Navigator.push(
  context,
  MaterialPageRoute<void>(
    builder: (_) => JiraAuthScreen(
      onAuthorized: (domain, email, apiToken, projectId, projectKey) {
        // Credentials saved automatically to ISpectJiraClient
        ISpect.logger.good('Jira authenticated successfully');
      },
    ),
  ),
);

Custom Feedback Integration

ISpectBuilder(
  feedbackBuilder: (context, onSubmit, controller) => JiraFeedbackBuilder(
    onSubmit: onSubmit,
    theme: Theme.of(context),
    scrollController: controller,
  ),
  child: child,
)

Jira Action Items

ISpectOptions(
  actionItems: [
    ISpectActionItem(
      title: 'Report Bug',
      icon: Icons.bug_report_outlined,
      onTap: (context) {
        if (ISpectJiraClient.isInitialized) {
          Navigator.push(
            context,
            MaterialPageRoute<void>(
              builder: (_) => const JiraSendIssueScreen(),
            ),
          );
        } else {
          // Show authentication screen
          Navigator.push(
            context,
            MaterialPageRoute<void>(
              builder: (_) => JiraAuthScreen(
                onAuthorized: (domain, email, apiToken, projectId, projectKey) {
                  // Handle successful authentication
                },
              ),
            ),
          );
        }
      },
    ),
  ],
),

📦 Installation

Add ispect_jira to your pubspec.yaml:

dependencies:
  ispect_jira: ^4.1.4

🚀 Quick Start

import 'package:flutter/material.dart';
import 'package:ispect/ispect.dart';
import 'package:ispect_jira/ispect_jira.dart';

void main() {
  final iSpectify = ISpectifyFlutter.init();

  ISpect.run(
    () => runApp(MyApp(iSpectify: iSpectify)),
    logger: iSpectify,
    isPrintLoggingEnabled: true,
  );
}

class MyApp extends StatefulWidget {
  final ISpectify iSpectify;
  const MyApp({super.key, required this.iSpectify});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    // Initialize Jira client
    ISpectJiraClient.initialize(
      projectDomain: 'your-domain',
      userEmail: '[e-mail]',
      apiToken: 'your-api-token',
      projectId: '10007',
      projectKey: 'PROJECT',
    );
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      builder: (context, child) => ISpectBuilder(
        options: ISpectOptions(
          actionItems: [
            ISpectActionItem(
              title: 'ISpect',
              icon: Icons.bug_report_outlined,
              onTap: (context) {
                if (ISpectJiraClient.isInitialized) {
                  // Navigate to create issue screen
                  Navigator.push(
                    context,
                    MaterialPageRoute<void>(
                      builder: (_) => const JiraSendIssueScreen(),
                    ),
                  );
                } else {
                  // Navigate to auth screen
                  Navigator.push(
                    context,
                    MaterialPageRoute<void>(
                      builder: (_) => JiraAuthScreen(
                        onAuthorized: (domain, email, apiToken, projectId, projectKey) {
                          ISpect.logger.good('✅ Jira authorized');
                        },
                      ),
                    ),
                  );
                }
              },
            ),
          ],
        ),
        feedbackBuilder: (context, onSubmit, controller) => JiraFeedbackBuilder(
          onSubmit: onSubmit,
          theme: Theme.of(context),
          scrollController: controller,
        ),
        child: child ?? const SizedBox.shrink(),
      ),
      home: const HomePage(),
    );
  }
}

⚙️ Advanced Features

Custom Issue Creation

// Create issues programmatically
final issue = await ISpectJiraClient.createIssue(
  assigneeId: 'user-id',
  description: 'Bug description with context',
  issueTypeId: '10001', // Bug type ID
  label: 'mobile-app',
  summary: 'App crashes on startup',
  priorityId: '3', // Medium priority
);

// Add attachments to existing issue
final attachments = [File('screenshot.png')];
await ISpectJiraClient.addAttachmentsToIssue(
  issue: issue,
  attachments: attachments,
);

Client State Management

// Check client initialization state
if (ISpectJiraClient.isInitialized) {
  print('Jira client is fully configured');
  print('Project: ${ISpectJiraClient.projectKey}');
  print('Domain: ${ISpectJiraClient.projectDomain}');
}

if (ISpectJiraClient.isClientInitialized) {
  print('Jira API client is ready');
}

// Restart client with new credentials
ISpectJiraClient.restart();

Fetching Jira Data

// Get available projects
final projects = await ISpectJiraClient.getProjects();

// Get current user
final user = await ISpectJiraClient.getCurrentUser();

// Get issue types and statuses
final statuses = await ISpectJiraClient.getStatuses();

// Get available labels
final labels = await ISpectJiraClient.getLabels();

// Get project users
final users = await ISpectJiraClient.getUsers();

// Get boards and sprints
final boards = await ISpectJiraClient.getBoards();
final sprints = await ISpectJiraClient.getSprints(boardId: 123);

Custom Send Issue Screen

// Navigate with pre-filled data
Navigator.push(
  context,
  MaterialPageRoute<void>(
    builder: (_) => JiraSendIssueScreen(
      initialDescription: 'Pre-filled bug description',
      initialAttachmentPath: '/path/to/screenshot.png',
    ),
  ),
);

Localization Support

MaterialApp(
  localizationsDelegates: ISpectLocalizations.localizationDelegates([
    AppLocalizations.delegate,
    ISpectJiraLocalization.delegate, // Add Jira localizations
  ]),
  // ... rest of app configuration
)

📚 Examples

See the example/ directory for complete integration examples including:

• Basic Jira setup
• Custom ticket templates
• Multiple environment configuration
• Advanced authentication scenarios

🏗️ Architecture

ISpectJira integrates with Atlassian Jira Cloud through REST API:

Component	Description
ISpectJiraClient	Singleton client managing Jira API communication
JiraFeedbackBuilder	Custom feedback widget with Jira integration
JiraAuthScreen	Authentication and project selection interface
JiraSendIssueScreen	Complete issue creation with attachments
Screenshot Capture	Automatic screenshot attachment system

🤝 Contributing

Contributions are welcome! Please read our contributing guidelines and submit pull requests to the main branch.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Related Packages

• ispect - Main debugging interface
• ispectify - Foundation logging system
• atlassian_apis - Jira REST API client
• feedback - User feedback system

---

Built with ❤️ for the Flutter community