Projects are big buckets for your ideas: a native app, a website, or webapp. Organize projects by client, platform, product, or team. Use projects to organize work that suits your team’s needs. Each project has a Master section. Think of this as the source of truth, the space everyone goes to find the latest versions of approved work.
Once you create a new project, import or create Sketch files to your new project to get started. By importing or creating files in Abstract, your project becomes a repository—to borrow from Git terminology. Though Abstract is built using Git, we’ve streamlined the process so design teams don’t have to use the command line to access, commit, or merge work. You can do it all with Abstract.
A branch is a personal workspace for contributors in Abstract. A branch references file versions from master that the contributor can edit and update with each commit before merging the final approved version back to master. Since a branch is a personal workspace, the contributor who creates the branch has more editing permissions on that branch than other contributors in the project or organization. To create a branch, click the New Branch button from the upper-right corner of Master or any existing branch. Use the textboxes to name and describe your branch to make it easy for your team to know more about what you’re working on.
Once your files are all squared away, use the EDIT IN SKETCH button from your branch to start working. Do your thing: create, edit, improve, iterate. When you’ve reached a stopping point, it’s time to commit your work to Abstract. A commit is a snapshot of the changes you’ve made to a file in a branch. A commit provides context to the changes in your work; it includes an overview of visual and non-visual changes and provides a space to document the changes for your team. Commit every time you make a change to your branch: a new exploration, when you finish a chunk of work, or when you change direction.
Once you’ve made some changes, click the Preview & Commit button and Abstract will open the commit window. Name and describe your commit using the textboxes. Here, you’ll see new and edited artboards, symbols, and non-visual changes you may have made while working since your last commit. In the right column, there is an option to commit this work to your current branch or to create a new branch instead—you never know when inspiration will strike. This way, you don’t lose any of your explorations. Additionally, if you commits from several files in this branch, you can select which files you’d like to commit and which you’d like to save for later. Click COMMIT CHANGES when you’re ready and take a moment to sit back, relax, and enjoy your first commit in Abstract. Repeat until you’re ready to merge.
A merge allows you to bring the edits you’ve committed on a branch together once your work is final or ready to ship. Since a branch references file versions from master, Abstract merges the updates you’ve made with the file versions in master of that project. How’s that work looking? Share your changes with the team to review what you’ve done. Oh, what’s that? Everybody says it looks sweet? Great! merge that branch into Master so it becomes part of the source of truth. Kapow! You’re on your way to Master-ing Abstract!