Using Pieces + Flutter to build Pieces

anushka-23g - Mar 16 '22 - - Dev Community

Written By: Mack Myers

Pieces is tremendously helpful for the team building Pieces, especially when using Flutter and Dart. From saving common Widget declarations to extracting code from instructional videos, we reveal how the team building Pieces, uses Pieces.

Image description

What is Pieces?

Pieces is the fastest, smartest AI Assistant for snippets, enabling developers to automatically or manually save useful code snippets, extract code from screenshots, auto-complete code, and more.
To learn more about Pieces and how it improves developer productivity, click here.

Understanding our Stack

In order to understand how we use Pieces to build Pieces, it’s helpful to review our tech stack. Pieces is primarily built using Flutter and Dart. A while back, we chose Flutter and Dart for a few key reasons:

  1. One codebase, multiple platforms
  2. Strong-typed
  3. Can utilize platform-specific APIs if needed
  4. High-performance rendering and animations out-of-the-box
  5. Default code style and conventions
  6. Works for desktop apps, web apps, and mobile apps

In contrast to common front-end tools like HTML, CSS, and JS, Flutter is all-encompassing. Meaning, you declare your UI, styles, and business logic all within the same file and tree using a class-based syntax and structure.

Further, instead of a DOM tree, Flutter utilizes a widget tree. Widget trees are where you find all UI elements (referred to as widgets in Flutter). Like a DOM tree, widget trees get complex extremely fast, and developers find themselves reusing a lot of the same widgets and callback functions across many areas of an application.

Pieces + Flutter = ❤️

While building the Pieces app with Flutter and Dart, our team found many valuable use cases for saving snippets in the Pieces app to improve our productivity. Let’s review some of them.

Saving & Reusing Widgets

Common Container Widget Template<br>

If you’ve ever written with Flutter, you’ve probably seen a snippet just like this a thousand times. This is a preset container with a templated child widget for easy plug and play.

One might think, “Can’t you just abstract this away into a new widget?” Yes, of course, you can, but that abstracted widget will still include its own set of custom properties in order to use it. Both a custom widget and a Flutter widget can have many different properties, which can be hard to remember.

When building the Pieces app, we saved snippets like this into Pieces ALL. THE. TIME. Once you save, quickly give it a name and continue on.

When I need to reuse this Container Widget again, which is in almost every Widget, Pieces makes it simple to find with a fast, non-obtrusive search. All I need to do is enter a keyword (i.e: Container), or some of the metadata — where it’s from, the title, description, or tags.

Now, we no longer worry about messing up another widget tree in order to copy and paste it.

Saving Flutter & Dart Examples

When combing through Flutter & Dart doc sites or watching demo videos, there are hundreds of code examples that come in handy when implementing new features or figuring out which widget to use for certain purposes.

Where Pieces really comes in handy is being able to (1) save these code examples with a single click while also capturing the context of where it came from and (2) extract code from a screenshot from, say, a YouTube demo video.

Using the Pieces Chrome Extension

Flutter Documentation with “Save to Pieces” Button

Using the example screenshot above, when creating a grid list with Flutter, I use the Pieces Chrome Extension to single-click save the code snippet while automatically tagging the website it came from.

Now, when I need to use a grid widget in Pieces, I can find this example and the link to the documentation in a matter of seconds.

Pieces Desktop App on macOS

Using Pieces OCR (Optical Character Recognition)

The other great way we use Pieces when saving Flutter, Dart, and other code examples, is using the OCR feature to extract text/code from screenshots.
One of the best ways to learn how to use specific Widgets is to watch Flutters Widget of the Week videos on YouTube. These are short, extremely focused examples of implementing a Widget.
Since these videos move quickly, we often take screenshots of the final implementation so we can (1) reference the code later on and (2) actually use the code from the example.
We do this by simply dragging the screenshot into Pieces and voila, the code is extracted and ready to use.
To see OCR in action, click here.

Import Statements

Common Import Statements

Nothing is more annoying than having to manually write an import statement. Flutter does have nice tools to alleviate this pain, but even they can be very annoying if you’re moving quickly.

As shown in the screenshot above, most of our files require some of the same common imports. The annoying thing, even when using Flutter and Dart tooling, is that you still have to make extra keystrokes to import all of the classes you’re using in the file.

Pieces has become a lifesaver when dealing with imports. When starting a new file, we can instantly grab the common imports that we know we’ll need and paste them into our new file. This way, we don’t have to spend time command-clicking, guessing file paths, or finding the import in another file.

Restructuring Widget Trees

I’ll admit, sometimes it gets a little scary when you’re about to restructure a loaded widget tree. Oftentimes, 99% of the tree is functioning nicely, but there’s that 1% that needs an upgrade or bug fix.

When this happens, I (1) don’t want to cause any regressions, (2) need to refer to my old tree to make sure I have feature-parity, and (3) don’t want to flip back and forth trying to decode my Git changes. So, to make life easier, I save my old tree in Pieces!

This gives me great peace of mind knowing that I can always refer back to the old tree if needed, and now can confidently start my updates on a blank canvas.

Carousel Widget Tree in Pieces

Merge Conflicts

Have you ever spent a few days working on something with a lot of nitty-gritty details and you’re a little nervous something might get messed up when it’s time to merge? Well, when working with Flutter, you know sometimes merge conflicts with widget trees can be impossible to read, especially when you start trying to line up closing parenthesis, brackets, and semicolons.

Another way we use Pieces is to help manage merge conflicts. Even if it is a temporary save, Pieces is great for storing a chunk of code as a backup in case you mess up your merge.

After all, the last thing any developer wants is broken code on the main branch. Thankfully, Pieces helps address that concern.

Get Started for Free

As cheesy as it may sound, Pieces is a product built for developers, by developers. Every day, we’re using Pieces to solve big and small problems for ourselves and thinking about how other developers might benefit.

If you experience some of the challenges mentioned above or anything similar, get started with Pieces today FOR FREE.

No account or personal information is required, and it runs 100% on your local machine!

Click here to learn more or here to install it on macOS or Windows.

Further reading…

If you haven’t already, be sure to check out how you can use Pieces to extract text/code from screenshots.
Learn about some of our recent features and updates via our updates page.
Share with us how we can continue to improve Pieces!

Cheers!

Mack

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .