Projects
Organize your work with Kanban projects, customizable workflows, and team access controls.
Projects (formerly called Boards) are your workspaces in Spedy. Each project represents a team, a product, or any workstream you want to track. Inside a project, you'll find all of your tickets organized in a visual Kanban layout that makes it easy to see what's happening at a glance.
The Kanban View
When you open a project, you'll see your tickets laid out across columns. Each column represents a status in your workflow -- for example, "Backlog", "To Do", "In Progress", or "Done". To move a ticket forward, simply drag it from one column to the next. The change is saved automatically.
Every status column belongs to one of four categories that help Spedy understand where a ticket sits in its lifecycle:
| Category | What it means | Examples |
|---|---|---|
| Planning | Work that hasn't started yet | Backlog, Triage |
| Blocked | Work that is stuck and needs attention | Blocked |
| Active | Work that's currently in progress | To Do, In Progress |
| Final | Work that's finished | Done, Cancelled |
You can customize the statuses and columns that appear on each project to match how your team actually works.
Creating a Project
To create a new project, click the New Project button in the sidebar. Give your project a name and a short prefix (for example, "ACME"). This prefix is used to generate readable ticket IDs like ACME-1, ACME-2, and so on -- making it easy to reference tickets in conversations or messages.
Connecting a repository while creating
In the same dialog, the GitHub repository section decides where the project's code comes from. There are four options:
| Option | What happens |
|---|---|
| Generate from template | Spedy creates a new, private repository in your organization and copies a project template into it |
| Create new repository | Spedy creates an empty private repo and pushes a starter (Shopware 6 or Magento 2) into it |
| Connect existing repository | Links an existing repo. No code is pushed into it |
| Skip | A ticket-only project without a code workspace. You can connect a repo later from the project settings |
Creating a project from a template
If you pick Generate from template and then a template from the list, Spedy:
- creates a new, private repository in your own organization through your active Git integration,
- clones the template and pushes it into that repository,
- links the repo to the project and sets it as the preview repository.
The repository name is derived from the project name (lowercase, special characters become dashes).
Where does the repo end up? Always in your own organization -- at the provider whose integration is active. If both GitHub and GitLab are connected, GitHub is used; if only GitLab is connected, the project is created in GitLab. Connect your provider first under Settings → Integrations.
Template and target are independent of each other. A template hosted on GitHub can end up in a GitLab project -- and the other way round.
What gets copied: the template with every branch and tag, so the complete history -- including the preview configuration (docker-compose.yml and .spedy/) if the template ships one.
The built-in Spedy templates (Shopware, Magento, Next.js) are public and need no credentials at all. You register your own templates under Settings → Project templates; they are read with your own integration's token.
Things to know
- The empty target repository is created before the content is pushed into it. If the push fails, an empty repo is left behind and the error message names it. Delete it, or pick a different project name on the next attempt -- otherwise the repository name collides.
- The project is created either way. If the repo step fails you get an error message but keep the project, and you can connect the repository later from the project settings.
- Self-hosted GitLab: the instance has to be reachable at a public address. Internal addresses are rejected when creating and pushing.
- Large templates take a moment -- the copy runs while the dialog is still open.
Editing and Archiving Projects
Open your project settings to rename the project, change its prefix, or adjust its workflow columns. If a project is finished or paused, you can archive it to remove it from your active list without deleting any data. Archived projects can be restored at any time from the settings area.
Project Access Roles
Not everyone needs the same level of access to a project. Spedy provides three roles to control what each person can do:
| Role | What they can do |
|---|---|
| Project Admin | Full control -- manage members, change settings, create and edit tickets |
| Project Member | Create, edit, and manage tickets on the project |
| Project Viewer | View tickets and project content in read-only mode |
You can add individual users to a project, or assign an entire team so that all team members automatically get access. Organization administrators always have access to every project.
Project Icon
Every project has a square icon -- in the project overview, in the project header, and everywhere else the project appears. You have three options:
| Kind | What you see |
|---|---|
| Prefix (default) | The project prefix on a colour tile. Active without you doing anything, on every existing project |
| Glyph | A symbol from a curated catalog of around 50 glyphs -- grouped into product, engineering, web & commerce, design, communication and analysis |
| Image | Your own logo, centre-cropped to 256 × 256 automatically |
Setting the icon
- Open Project → Settings → General
- Go to the Project icon section
- Pick a colour (12 tints from neutral through teal to rose) and a glyph -- or click Upload image
Every pick is saved immediately, there is no save button. The preview at the top of the section shows how the project will appear everywhere else.
Notes
- Back to the prefix: click the active glyph again -- the project shows its monogram once more. Remove an uploaded image with Remove image.
- The colour applies to prefix and glyph: an uploaded image brings its own colours, so the tint no longer affects the icon.
- Accepted files: PNG, JPEG and WebP up to 512 KB. SVG is deliberately not accepted.
- Permission: changing the icon needs the same permission as the rest of the project settings (boards:edit).
View Modes
Every project offers two views. Switch between them using the view switcher at the top of the project page. Your selection is saved per project in your browser.
| View | What it shows |
|---|---|
| Board | Classic Kanban status columns -- drag tickets between them to change status |
| List | A compact vertical list of all tickets |
Both views share the same board filters and open the ticket side panel when you click a ticket.
The table view has been removed. It showed the same tickets with the same filters as the list view. If table was your last active view, Spedy simply opens the project in Board again -- there is nothing you need to change. For a tabular view across several projects, use the Issues Hub.
For a time-based overview of start and due dates, see the separate Timeline page.
Project Folders
Project folders group your projects on the overview page -- for example by client type, department, or priority. Folders appear as collapsible sections in both the grid and list layouts.
Creating and Using Folders
- Open the Project Overview
- Click New Folder and enter a name
- Drag projects into the folder via drag-and-drop -- or use the Move to menu on the project card
Projects without a folder remain at the top of the overview. Each folder's collapsed/expanded state is remembered between sessions.
Permissions
- Creating folders requires the boards:create permission
- Renaming, reordering, and deleting folders requires boards:edit
- Deleting a folder does not delete the projects inside -- they are moved back to the ungrouped section
Folders are visible organization-wide but hidden from external customer accounts.
Project Favorites
Star the projects you access most often. Hover over a project card on the overview page and click the star, or use the star icon in the project header. The star turns amber/gold and the project is pinned at the top of the sidebar projects menu.
Favorited projects appear above a divider, with your recently visited projects listed below -- sorted alphabetically instead of cut off. The sidebar shows 5 pinned projects initially; scroll to reveal more. Favorites are personal -- only you see your own, and they are cleared when you switch organizations. You can have up to 200 project favorites.
To remove a project from your favorites, click the star again on the project card or in the project header.
Project Settings
From the project settings page, you can:
- Rename the project or update its prefix
- Manage which statuses and columns appear on the project
- Add or remove team members and set their roles
- Archive or restore the project