Dart Project Management Api

About Dart 🎯

Dart is an AI-powered project management platform that helps teams organize their work efficiently. It provides a modern interface for managing projects, tasks, and team collaboration, with features like AI-assisted task management, real-time updates, and powerful automation tools.

About This API 🔌

This package is a Dart client library that allows you to interact with the Dart platform programmatically. It provides a simple way to:

Create and manage projects
Create and update tasks
View project configuration
Handle authentication with Dart's platform

Example Usage

import 'package:dart_project_management_api/dart_project_management_api.dart';

void main() async {
  // Initialize the API with your Dart token
  final dartApi = DartProjectManagementApi(
    token: 'your-dart-token-here', // Get this from Dart Settings > Account
  );

  // Add a task
  final task = await dartApi.createTask(
    TaskRequest(
      dartboard: 'project_id',
      title: 'Implement new feature',
      description: 'Task description',
      // Add other optional fields if needed
    ),
  );

  // Ajouter un commentaire à une tâche
  final comment = await dartApi.createComment(
    CommentRequest(
      taskId: task.id!,
      text: 'This is a comment',
    ),
  );

  // View project configuration
  final config = await dartApi.getConfig();

  // Example of accessing configuration:
  print('Today\'s date: \\${config.today}');
  print('User: \\${config.user.name}');
  print('Available dartboards: \\${config.dartboards}');
  print('Available types: \\${config.types}');
  // ... other properties as needed
}

Authentication 🔑

To use this API, you need to obtain an authentication token from your Dart account:

Log in to your Dart account
Go to Settings > Account
Scroll down to find your API Token
Copy the token and use it to initialize the API

Available Operations 📋

Projects

Create projects
List projects
Get project details
Update project information
Delete projects
View project configuration

Tasks

Create tasks
List project tasks
Update task details
Change task status
Add comments to tasks

Error Handling ⚠️

try {
  final project = await dartApi.createProject(
    name: 'New Project',
  );
} on DartApiException catch (e) {
  print('API Error: \\${e.message}');
}

API Exceptions

All API errors throw a subclass of DartApiException. You can catch specific exceptions to handle different error cases:

DartApiUnauthorizedException — The request was not authorized (HTTP 401)
DartApiNotFoundException — The requested resource was not found (HTTP 404)
DartApiValidationException — The request was invalid (HTTP 400)
DartApiNetworkException — A network error occurred (connection issues, etc.)
DartApiUnknownException — Any other error returned by the API

Example

try {
  final task = await dartApi.getTask('task-id');
} on DartApiNotFoundException catch (e) {
  print('Not found: \\${e.message}');
} on DartApiUnauthorizedException catch (e) {
  print('Unauthorized: \\${e.message}');
} on DartApiValidationException catch (e) {
  print('Validation error: \\${e.message}');
} on DartApiException catch (e) {
  print('API error: \\${e.message}');
}

Description 📝

Dart Project Management Api is a comprehensive library that provides a simple and intuitive interface for managing projects, tasks, users, and teams. It is designed to be easy to integrate, performant, and extensible. Built to work harmoniously with Dart's AI-powered project management platform, this API enables developers to create custom integrations and extensions that leverage Dart's powerful AI capabilities.

Integration with Dart Platform 🔄

This API is designed to work seamlessly with the Dart project management platform, offering:

AI-Powered Features

Automatic property filling for tasks
AI-driven project planning
Intelligent subtask generation
AI chat integration
Duplicate task detection
Natural language processing for task creation
Automated report generation

Task Management

List and board views
Sprint planning and management
Priority and size tracking
Due date management
Custom property fields
Task dependencies
Real-time updates

Document Management

Integrated document editor
Meeting notes storage
Task-document linking
AI-powered report generation
Changelog updates
Standup meeting automation

Views and Layouts

Roadmap visualization
Gantt charts
Calendar views
Custom board layouts
Command center
Team-specific views

Integration Capabilities

GitHub integration for development workflows
Slack and Discord for team communication
ChatGPT and Claude for AI assistance
Microsoft Teams integration
Zapier for workflow automation
Google Calendar and Spreadsheets
Notion integration
Custom API endpoints

Role-Based Features 👥

The API supports Dart's role-specific features:

For Engineering Teams

GitHub integration for PR tracking
Sprint management
Automated standup reports
Code review workflows

For Product Teams

PRD drafting with AI
User feedback tracking
Project timeline estimation
Feature prioritization

For Design Teams

AI-assisted design tasks
Design asset management
Task-document integration
Voice control support

For Sales Teams

Pipeline management
CRM integration
Team communication tools
Deal tracking

Project Configuration ⚙️

The API allows you to view your Dart project configuration:

final dartApi = DartProjectManagementApi(
  token: 'your-dart-token-here',
);

// Get project configuration
final config = await dartApi.getConfig();

// La configuration contient les informations suivantes :
print('Current date: ${config.today}');
print('Current user: ${config.user}');
print('Available dartboards: ${config.dartboards}');
print('Available folders: ${config.folders}');
print('Available types: ${config.types}');
print('Available statuses: ${config.statuses}');
print('Available assignees: ${config.assignees}');
print('Available tags: ${config.tags}');
print('Available priorities: ${config.priorities}');
print('Available sizes: ${config.sizes}');

Contributing 🤝

Contributions are welcome! Feel free to:

Fork the project
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request