8579029a2e
* Done! Created [creating-task-tags.mdx](file:///private/var/folders/5q/5vgq75y92dz0k7n62z93299r0000gn/T/vibe-kanban/worktrees/ced3-docs-task-tags/docs/configuration-customisation/creating-task-tags.mdx) and updated [docs.json](file:///private/var/folders/5q/5vgq75y92dz0k7n62z93299r0000gn/T/vibe-kanban/worktrees/ced3-docs-task-tags/docs/docs.json). ## Required Image Updates The old template screenshots need to be replaced with new task tag screenshots: **Replace:** 1. `screenshot-global-task-templates.png` → `screenshot-task-tags-manager.png` (Settings → General → Task Tags table view) 2. `screenshot-project-task-templates.png` → Delete (project-specific tags no longer exist) 3. `screenshot-create-task-template-dropdown.png` → Split into: - `screenshot-create-task-tag.png` (tag creation dialogue) - `screenshot-task-tag-autocomplete.png` (@mention dropdown in task description) * Updated! The documentation now mentions that task tags work in both task descriptions and follow-up messages. * Copied to [screenshot-task-tags-manager.png](file:///private/var/folders/5q/5vgq75y92dz0k7n62z93299r0000gn/T/vibe-kanban/worktrees/ced3-docs-task-tags/docs/images/screenshot-task-tags-manager.png)! Still need: - `screenshot-create-task-tag.png` (tag creation dialogue) - `screenshot-task-tag-autocomplete.png` (@mention dropdown) * Perfect! All three screenshots are now in place: - [screenshot-task-tags-manager.png](file:///private/var/folders/5q/5vgq75y92dz0k7n62z93299r0000gn/T/vibe-kanban/worktrees/ced3-docs-task-tags/docs/images/screenshot-task-tags-manager.png) - [screenshot-create-task-tag.png](file:///private/var/folders/5q/5vgq75y92dz0k7n62z93299r0000gn/T/vibe-kanban/worktrees/ced3-docs-task-tags/docs/images/screenshot-create-task-tag.png) - [screenshot-task-tag-autocomplete.png](file:///private/var/folders/5q/5vgq75y92dz0k7n62z93299r0000gn/T/vibe-kanban/worktrees/ced3-docs-task-tags/docs/images/screenshot-task-tag-autocomplete.png) The old template images can now be deleted if desired. * All done! Updated all references: - [creating-tasks.mdx](file:///private/var/folders/5q/5vgq75y92dz0k7n62z93299r0000gn/T/vibe-kanban/worktrees/ced3-docs-task-tags/docs/core-features/creating-tasks.mdx) - Changed "Using Templates" to "Using Task Tags" with updated workflow - [global-settings.mdx](file:///private/var/folders/5q/5vgq75y92dz0k7n62z93299r0000gn/T/vibe-kanban/worktrees/ced3-docs-task-tags/docs/configuration-customisation/global-settings.mdx) - Updated section to "Task Tags" with new link - [creating-projects.mdx](file:///private/var/folders/5q/5vgq75y92dz0k7n62z93299r0000gn/T/vibe-kanban/worktrees/ced3-docs-task-tags/docs/core-features/creating-projects.mdx) - Removed project-specific template reference - Deleted old template documentation and images can stay for now until you verify the new screenshots work * Done! Deleted all old template screenshots. The documentation migration from task templates to task tags is now complete.
53 lines
2.5 KiB
Plaintext
53 lines
2.5 KiB
Plaintext
---
|
|
title: "Creating Projects"
|
|
description: "Learn how to create and configure projects in Vibe Kanban"
|
|
---
|
|
|
|
Before you can create tasks and execute coding agents, you must create a project.
|
|
|
|
<Frame>
|
|
<img src="/images/vk-create-project.png" alt="Create project dialog showing options to create from existing git repository or blank project" />
|
|
</Frame>
|
|
|
|
## Creating Your Project
|
|
Click the **Create Project** button to choose from two options:
|
|
- **From existing git repository**: Browse your file system and select from a list of git repositories sorted by recent activity
|
|
- **Create blank project**: Generate a new git repository from scratch
|
|
Each project represents a git repository. After creation, you can configure it with setup scripts, dev server scripts, and other settings.
|
|
|
|
|
|
<Note>
|
|
After creating a project, you need to press the settings button in the top right to configure project scripts and settings.
|
|
</Note>
|
|
|
|
## Project Settings
|
|
|
|
Once you've created a project, you can access the project settings by clicking the settings button in the top right corner. From here, you can configure various aspects of your project.
|
|
|
|
### Setup Scripts
|
|
|
|
Setup scripts will be run before the coding agent is executed. This is useful for installing dependencies, for example you might run `npm install` or `cargo build`. This will save you time as your agent won't need to figure out that these commands haven't already been run.
|
|
|
|
<Note>
|
|
Each time a coding agent is executed it runs in a [git worktree](https://git-scm.com/docs/git-worktree) which is unlikely to contain your dependencies, configs, .env etc.
|
|
</Note>
|
|
|
|
### Dev Server Scripts
|
|
|
|
The dev server script is run when you press the "Start Dev Server" button from the [Preview](/core-features/testing-your-application) section. It's useful for quickly reviewing work after a coding agent has run.
|
|
|
|
### Cleanup Scripts
|
|
|
|
Cleanup scripts run after a coding agent finishes it's turn. You can use these to tidy up the workspace, remove temporary files, or perform any post-execution cleanup. For example, you might run `npm run format` to ensure your code is formatted correctly. Treat it like a git pre-commit hook.
|
|
|
|
|
|
### Copy Files
|
|
|
|
Comma-separated list of files to copy from the original project directory to the worktree. These files will be copied after the worktree is created but before the setup script runs. Useful for environment-specific files like `.env`, configuration files, and local settings.
|
|
|
|
<Warning>
|
|
Make sure these files are gitignored or they could get committed!
|
|
</Warning>
|
|
|
|
|