Projects in Vectly

Projects are powerful organizational units that help you manage related chats, files, and context in one place. Whether you're working on a coding project, research paper, or business analysis, projects keep everything organized and accessible.

What are Projects?

Projects in Vectly are containers that:

• Group related chats together
• Share files and context across chats
• Track credit usage per project
• Maintain separate contexts for different work
• Enable future collaboration features

Creating Projects

Quick Start

1. Click "New Project" in the sidebar
2. Enter a descriptive name
3. Add an optional description
4. Click "Create Project"

Project Settings

Each project includes:

• Name: Descriptive title for easy identification
• Description: Optional details about the project
• Files: Shared documents across all project chats
• GitHub Repos: Connected repositories for code context
• Chat History: All conversations within the project

Project Features

Shared Context

How It Works

• Files uploaded to a project are available to all chats
• AI references project files automatically
• Context persists across conversations
• No need to re-upload for each chat

Benefits

• Consistent responses across chats
• Reduced credit usage
• • Does not use the entire document, only necessary chunks
• • No repeated uploads
• Better AI understanding of your work
• Seamless context switching

File Management

Supported File Types

• Documents: PDF, TXT, MD, DOCX
• Code: All programming languages
• Data: CSV, JSON, XML
• Archives: ZIP (automatically extracted)

File Operations

• Upload: Drag and drop or click to upload
• View: See processed content
• Delete: Remove when no longer needed
• Update: Replace with newer versions

GitHub Integration

Connecting Repositories

1. Go to project settings
2. Click "Connect GitHub Repository"
3. Authorize Vectly (first time only)
4. Select repositories to connect
5. Choose files to include/exclude

Repository Features

• Automatic syncing with latest changes
• File pattern filtering (include/exclude)
• Branch selection
• Commit history awareness
• Code search across repos

Organizing with Projects

Best Practices

1. Project Structure

Create projects for:

• Different clients or customers
• Separate applications or codebases
• Research topics or subjects
• Course work or learning paths
• Personal vs. professional work

2. Naming Conventions

Use clear, descriptive names:

• ❌ "Project 1", "New Project"
• ✅ "E-commerce Website Redesign"
• ✅ "Machine Learning Course - Stanford"
• ✅ "Client: Acme Corp - Q4 Analysis"

3. Context Management

• Keep related files together
• Remove outdated documents
• Update files as work progresses
• Use consistent file naming

Project Templates (Coming Soon)

• Pre-configured project structures
• Industry-specific templates
• Custom template creation
• Quick project setup

Working with Project Chats

Creating Chats in Projects

1. Select project from sidebar
2. Click "New Chat" within project
3. Chat automatically inherits project context
4. All project files are accessible

Chat Organization

• Chats are listed chronologically
• Search within project chats
• Star important conversations
• Archive completed chats

Moving Chats Between Projects

1. Open chat options menu
2. Select "Move to Project"
3. Choose destination project
4. Chat adopts new project context

Project-Level Features

Credit Tracking

• View credits used per project
• Export usage reports
• Set budget alerts (coming soon)
• Track ROI per project

Access Control (Coming Soon)

• Share projects with team members
• Set read/write permissions
• Collaborate in real-time
• Track team member contributions

Project Analytics

Monitor project activity:

• Total chats and messages
• Credit consumption trends
• Most active time periods
• File usage statistics

Advanced Project Usage

Multi-Project Context

Working across projects:

• Reference files from other projects
• Link related projects
• Copy context between projects
• Global search across all projects

Project Automation (Coming Soon)

• Scheduled context updates
• Automatic file processing
• GitHub webhook integration
• API access for projects

Export and Backup

• Export entire project history
• Download all files and chats
• Backup project configuration
• Restore from backups

Project Limits

Current Limits by Plan

Storage Management

• Files are compressed and optimized
• Unused files can be archived
• Storage counts against total limit
• Additional storage available

Tips for Effective Projects

1. Start Organized

• Create projects before uploading files
• Plan your project structure
• Use consistent naming
• Document project purpose

2. Maintain Context

• Update files regularly
• Remove outdated information
• Keep context relevant
• Use version control

3. Leverage Features

• Use GitHub integration for code
• Upload documentation early
• Share context across chats
• Monitor credit usage

4. Stay Focused

• One topic per project
• Clear project boundaries
• Archive completed work
• Regular cleanup

Common Use Cases

Software Development

• Upload requirements documents
• Connect GitHub repositories
• Track development conversations
• Generate documentation

Research Projects

• Upload research papers
• Maintain bibliography
• Track analysis chats
• Generate summaries

Content Creation

• Upload style guides
• Maintain brand documents
• Track content drafts
• Generate variations

Business Analysis

• Upload data files
• Connect data sources
• Track analysis chats
• Generate reports

Troubleshooting

Project Issues

Can't Create Project

• Check plan limits
• Verify account status
• Clear browser cache
• Contact support

Files Not Processing

• Check file format
• Verify file size
• Ensure not corrupted
• Try re-uploading

GitHub Sync Issues

• Verify permissions
• Check repository access
• Confirm webhook setup
• Review sync logs

Future Features

Coming soon to projects:

• Team collaboration
• Project templates
• Advanced permissions
• API integration
• Custom workflows
• Project marketplace

Need help with projects? Contact [email protected]