Skip to content
sprintrrdocs
Sign in

Projects

Create, structure, and manage projects — the top-level container for milestones and tasks.

on this page

    A project is the container for a body of work. It can be generated by AI or created entirely by hand.

    Fields

    FieldMeaning
    NameThe project's title.
    DescriptionWhat the project is about; also feeds AI context for generation.
    WorkspacePersonal (private to you) or a Team (shared). Set by team_id when the project is created; it doesn't change afterwards.
    Tech stackA list of technologies. Suggested by AI generation; freely editable.
    Success metricsThe outcomes that define "done well".
    Sprintscurrent_sprint and total_sprints for week/sprint planning.
    AI-generatedA flag indicating the project originated from AI generation.

    Creating a project

    With AI — see AI generation. You provide a prompt, type, duration, and complexity; sprintrr produces the project with milestones and tasks already populated.

    Manually — create an empty project and add milestones and tasks yourself. Manual projects behave identically; the only difference is the AI-generated flag.

    Personal vs. team projects

    A project belongs to a personal workspace when it has no team, or to a team workspace when it is created in that team's workspace. A project stays in the workspace it was created in. Team projects are visible to every member of the team; personal projects are private to you. Switch workspace from the sidebar to see the corresponding projects.

    In a team, every member can edit the team's projects, but only the project's creator or the team's owner can delete one. When someone leaves a team or is removed, the projects they created there move to the owner. See Teams.

    Organizing with folders

    Projects in the sidebar can be grouped into folders, up to two levels deep:

    text
    Folder
└── Subfolder
    └── Project

    Subfolders can hold projects but cannot themselves contain more folders — the database rejects a third level of nesting.

    Folder scope mirrors project scope: in a team workspace folders are shared across the team, in a personal workspace they're private to you. The two are never mixed — you can't move a personal project into a team folder.

    Working with folders from the sidebar:

    • New Folder — creates a root folder. Click the action menu (⋯) on a folder to add a subfolder, rename, or delete it.
    • Move to folder… — open a project's action menu and pick a destination (or "No folder (top level)") from the indented tree.
    • Expand / collapse — click the chevron next to a folder name. State persists across reloads.
    • Deleting a folder keeps every project inside — they move back to the top level. Folder delete never deletes projects.

    Archiving vs. deleting

    Two distinct actions for retiring a project:

    • Archive — soft state. The project disappears from the main sidebar list but is still there in a collapsible Archived section at the bottom. Unarchive at any time to restore it. Tasks, milestones, and the folder location are all preserved. Use this for projects you've wrapped up but want to keep around.
    • Delete — permanent. Removes the project and every task and milestone under it. There is no trash/restore. Export first if you want a copy (see Data & export). In a team, only the project's creator or the team's owner can delete it.

    warning:

    Deletion cascades: removing a project removes every task and milestone under it. There is no trash/restore — archive instead if you might want it back later.

    • Milestones — checkpoints within a project.
    • Tasks — the unit of execution.
    • Data & export — export a project as JSON, CSV, or a reusable template.

    Something unclear or out of date? Email support@sprintrr.ai — the subject line already names this page.