Introducing Click to Edit

How we Organize our Files and Projects in Figma

To kick off this multi-part series, let's look into the high-level overview of our team and project setup.
Darshan Gajara

Last updated by Darshan 

Dec 03, 2025

Originally written by Darshan

How we Organize our Files and Projects in Figma

As the Head of Design at Hygraph, I'd like to share our design process at Hygraph.

This will be a multi-part series, so let me start by giving you a high-level overview of our team and project setup. We're a fairly small team, so we only need one team account in Figma. Under our team, we've got separate projects for:

  • ⚡️ Feature
  • 🎨 Baukasten (our Design System)
  • 🔥 Marketing

A screenshot of the Figma sidebar organization at Hygraph, illustrating a structured project hierarchy with categorized folders for Feature, Marketing, and Reference Apps to optimize design team collaboration

We also maintain other non-regular projects like Feedback, Figma Crash Course, Reference Applications, etc.

#What goes into each project

⚡️ Feature

A view of the Figma project dashboard for the 'Feature' category at Hygraph, showing a grid of specialized design files - including Scalar Field Modal, Relational Field Modal, and Migration Tools - to maintain a structured and searchable design system workflow

This project is dedicated to new features and improvement work on the product. At present, our web app is our only product, so it's relatively easier to keep everything feature-related under one project.

🎨 Baukasten

A view of the Figma project dashboard for the 'Baukasten' design system at Hygraph, showing organized folders for 'Get Started', 'Foundation', and 'Components' to ensure a consistent and scalable design-to-code workflow

Baukasten is a German word for construction kit. Think of it as legos – the building blocks of our product. This project holds our style guides and components.

Note: We’ll do a separate post on our design system later. Keep an eye on this space.

🔥 Marketing

A screenshot of the Figma project dashboard for the 'Marketing' category at Hygraph, displaying a grid of specialized design files, including Blog Components, Video Covers, Social Media, and Product Updates, to ensure brand consistency across all digital marketing channels

The project is dedicated to our marketing website and community work, which includes docs, blog posts, videos, GitHub repos, conferences, social media, etc. The community is central to our product and we try to support our developer advocates with graphics and assets as much as we can.

Apart from these 3 main projects, we create new projects for non-regular work. For example, I did a Figma training session for our team when we moved to Figma as our design tool. So we created a new project to use as a playground.

A screenshot of a collaborative Figma playground workspace at Hygraph, featuring real-time design team collaboration with multiple active cursors and a video call sidebar during a training session on Union Types in GraphCMS

To understand how this process works, let’s take a deeper dive into the Feature project setup.

#⚡️ Feature

A screenshot of the Figma Layers and Pages panel for a 'Feature' design file at Hygraph, demonstrating a standardized page structure that includes Research, Scratchpad, UI, Prototype, and QA to streamline the design-to-development handoff

Let's peek inside a feature file. Every feature file has these separate pages:

  • Cover
  • 🔍 Research
  • 📝 Scratchpad
  • ✅ UI
  • ▶️ Prototype
  • 👌 QA

Here’s what goes inside every page:

Cover

A standardized Figma file cover template used at Hygraph, featuring a dark theme with a placeholder for the project title, the date range, and a visual workflow status bar indicating stages from Discovery and Design to Live

We dedicate the first page of the file to the cover. A cover can also be set by using a frame as a custom thumbnail but it doesn't scale well for different screen sizes. So it's better to set it up on a separate page with the same background. That way you can let Figma automatically pick your first page as the cover of the file.

A file cover makes it easier to identify the relevant file in a sea of many files. We also use it to indicate the collaborators, timeline, and status of the feature. The cover template we use is based on Ramy Majouji's freebie.

🔍 Research

A screenshot of the Figma Research page for a feature at Hygraph, displaying a collection of competitor references and design mood boards for scheduling UI components. This page serves as a centralized hub for project specs and visual inspiration during the design discovery phase

The page dedicated to all the research done around that feature. This includes things like specs, notes, competitor references, design mood boards, etc. Basically, everything that's needed to design the feature.

📝 Scratchpad

A view of the Figma Scratchpad page for a feature at Hygraph, displaying multiple design explorations and UI mockups for Scheduled Publishing modals. This illustrates a dedicated, non-destructive space for iterative design and brainstorming within a structured Figma workflow

This is the messy middle, this is where the fun lies. It's an open canvas to explore ideas, try out different patterns, get feedback, and iterate. This is also the page where the most collaboration happens. And it's often flooded with comments from the team.

Here's an example from one of the recent feature files. Yes, it can get pretty crazy at times.

A zoomed-out overview of a complex Figma design file at Hygraph, showing a vast array of UI iterations and prototypes marked with numerous collaboration comments, illustrating the scale of high-fidelity design work for enterprise features

✅ UI

A structured Figma UI design page at Hygraph, displaying final user interface mockups organized into clear, labeled rows, such as 'Schedule Item - Publish' and 'Unpublish', to provide a production-ready reference for frontend developers and stakeholders

This is the most organized page in the file. It's where the final designs/user flows stay. It's also the source of truth for our engineers working on the given feature. They would develop the feature by inspecting the designs from here.

Frames on the ✅ UI page are organized based on user flows. You would notice that we use the default style to title them. That's to benefit from Figma's automatic scaling of frame titles on zoom in & out. We also use this page to leave relevant notes for our engineer friends.

▶️ Prototype

A screenshot of the Figma Prototype page at Hygraph, showing complex interaction design flows for a 'Relational Field Modal'. The canvas displays multiple connected frames with blue prototyping noodles illustrating the user journey and transition logic

This page is optional. We only make use of this page when we create prototypes for the given feature. Prototypes are usually only needed to communicate a complex design or to present the concept to other teams or customers.

👌 QA

A screenshot of the Figma QA page for a feature at Hygraph, showing a organized workspace for quality assurance and design reviews

When the feature gets developed, we're asked to review the PR on GitHub by our engineers. We review the feature in our preview environment, take screenshots of where there's a mismatch in design, paste it on this page and leave comments for our engineering team.

We’re aware that our QA process isn't ideal and we're constantly looking to improve it. So if you've got any recommendations or suggestions here, please feel free to reach out.

Also, we've created a template file with all these pages, base frames and pinned it to the top of the ⚡️ Feature project to make the process of starting a new feature work fast and easy.

Handling Design at Hygraph - Template

Keeping our files and projects organized in Figma has been massively beneficial for us and has made the process of collaboration between teams so much more efficient and fun. I hope you found this useful and can take away some principles to apply to your own process.

Blog Author

Darshan Gajara

Darshan Gajara

Darshan is a designer & maker living in Berlin, currently leading the design team at Hygraph. He also maintains Product Disrupt, writes stories about design & travel, interviews creators, mentors designers, and curates design resources.

Share with others

Sign up for our newsletter!

Be the first to know about releases and industry news and insights.