Projects in LatchLoop: Your Development Hub
Projects are the foundation of your work in LatchLoop. Each project serves as a container for tasks, connects to a single GitHub repository, and can be shared with your team for collaborative development. This guide covers everything you need to know about creating, managing, and working with projects.
1. What is a Project?
A Project in LatchLoop is:
- A collection of related tasks that work toward a common goal
- Connected to one GitHub repository for code management
- A workspace where you and your team can collaborate
- A hub for tracking progress from planning to deployment
Think of a project as your development workspace for a specific codebase – whether it’s a web app, mobile app, API, or any other software project.
2. Creating a New Project
Step-by-Step Project Creation
- From your dashboard, click “New Project” or use the
+ button.
- Enter a project name that clearly describes your work.
- Add an optional description to help team members understand the project’s purpose.
- Choose your privacy setting:
- Private: Only you can see and work on this project
- Team/Shared: Invite team members to collaborate
- Click “Create Project”.
Connecting to GitHub (Required)
After creating your project, you’ll need to connect it to a GitHub repository:
- Click “Connect GitHub Repository” in your new project.
- Select from your available repositories (requires GitHub App installation).
- Choose the appropriate branch (usually
main or develop).
- Optionally specify folders to ignore (e.g.,
node_modules,.git,dist).
- Click “Connect Repository”.
Note: Every project can be connected to exactly one GitHub repository. This connection enables LatchLoop to understand your codebase and manage code changes.
3. Project Privacy & Team Collaboration
Private Projects
- Who can access: Only you
- Best for: Personal projects, experiments, or sensitive work
- Features: Full functionality including AI assistance, task management, and GitHub integration
Shared/Team Projects
- Who can access: You and invited team members
- Best for: Team development, open source projects, or collaborative work
- Features: Everything in private projects plus:
- Team member invitations and role management
- Shared task assignment and tracking
- Collaborative AI conversations
- Team activity feeds
Inviting Team Members
- Open your project settings.
- Go to the “Team” or “Members” section.
- Click “Invite Member”.
- Enter their email address or LatchLoop username.
- Choose their role (if role-based permissions are available).
- Send the invitation.
4. Managing Project Settings
Access project settings from the gear icon or settings menu:
General Settings
- Project Name: Update the display name
- Description: Modify project description
- Privacy: Switch between private and shared (with restrictions)
- Archive/Delete: Archive completed projects or permanently delete
Repository Settings
- Connected Repository: View current GitHub connection
- Branch: Change the default branch for AI operations
- Ignored Folders: Update which directories LatchLoop should skip
- Reconnect: Refresh GitHub connection if needed
Team Management (Shared Projects Only)
- Current Members: See who has access
- Pending Invitations: Track sent invites
- Remove Members: Revoke access when needed
- Role Management: Assign different permission levels (if available)
5. Working with Tasks in Projects
Every task in LatchLoop belongs to a project:
- Create tasks specific to your project’s goals
- Import tasks from ClickUp or other tools
- Organize tasks using status filters and board or list view
- Assign tasks to team members for collaboration
- Track progress from planning to deployment
All AI-generated code changes are automatically committed to your project’s connected repository in task-specific branches.
6. Project Cleanup
Deleting Projects
⚠️ Warning: Deletion is permanent and cannot be undone.
- All tasks and project data will be lost
- GitHub repository and branches remain untouched
- Team members lose access immediately
7. Frequently Asked Questions
Q: Can I change which GitHub repository a project is connected to?
A: Yes, go to Project Settings → Repository and click “Change Repository” to connect a different repo.
Q: What happens if I delete the connected GitHub repository?
A: Your project will still exist in LatchLoop, but AI builds and code operations will fail until you connect a new repository.
Q: Can I move tasks between projects?
A: Yes, use the “Move Task” option in the task menu to transfer tasks to a different project.
Q: How many team members can I add to a project?
A: This depends on your LatchLoop plan. Check your account settings for current limits.
Q: Can I make a private project shared later?
A: Yes, you can change privacy settings in Project Settings, though some restrictions may apply.
Q: Do I need a GitHub repository to create a project?
A: You can create a project first, but you must connect a GitHub repository before the AI can generate or modify code.
8. Need Help?
If you have questions about projects or need assistance:
- Check our other help articles for specific features
- Email us at [email protected]
- Use the in-app help chat for quick questions
Happy building with LatchLoop!