English versionEN

Streamlining the Component Creation Process

React helped popularize the use of components to develop websites and apps. It’s a fantastic philosophy, but while components have made our websites better, the workflow for creating components hasn’t improved much. Let’s get rid of the tedious parts like wiring your components to your CMS, and let developers focus on the important parts. With Prismic Slice Machine, we’re giving developers the best workflow for creating components. In only a few minutes we’ll create a React component, wire it to our CMS, add it to Storybook, and push the component live on our site!

This talk has been presented at React Summit Remote Edition 2021, check out the latest edition of this React Conference.

FAQ

Slice Machine is a development workflow by Prismic that allows developers to quickly create components and gives editors the power to build the pages they need.

A Prismic slice is a repeatable, reusable section of your website that is integrated with the Prismic CMS.

You can create a new slice by running the command 'prismic sm create slice' in your terminal and specifying the slice folder and name.

When you create a slice, four files are generated: index.js (a React component), a Storybook story, mock data in the mocks folder, and a model file showing the data structure.

You can start the Slice Machine UI by running the command 'Prismic sm develop' in your terminal.

In the Slice Machine UI, you can add various types of fields such as rich text, image, and GeoPoint.

After creating and styling your slice, you can push it to Prismic by pushing your code to GitHub, which triggers Vercel to rebuild your Next.js app, and then adding the new slice in the Prismic repository's custom types.

Taking a snapshot allows editors to see a visual preview of the component, making it easier for them to choose the correct component in Prismic.

Editors can add the new slice to their pages by selecting it from the shared slices in their Prismic repository, filling in the content, and then saving or publishing the changes.

Prismic Slice Machine allows for quick component creation, seamless integration with Prismic CMS, easy development with Storybook, and provides visual previews for editors, making it a powerful tool for building and managing website content.

react react components

Alex Trost

9 min

14 May, 2021

Comments

Video Summary and Transcription

Slice Machine is a development workflow that allows for the creation of reusable sections of a website. The Talk covers the process of adding a map slice to an existing Next.js website and building the component. It also discusses styling the map slice, publishing changes, and triggering a rebuild. The summary highlights the key points of the Talk in a concise manner.

Available in Español: Optimizando el Proceso de Creación de Componentes

1. Introduction to Slice Machine

Short description:

Hey, Alex from Prismic here, and I'm going to talk to you today about Slice Machine, our new development workflow that lets you create components quickly and gives your editors the power to build the pages that they need. So what is Slice Machine? Well, a Prismic slice is essentially a repeatable, reusable section of your site that's wired up to the Prismic CMS, and Slice Machine is a development environment that makes creating slices a breeze.

So what is Slice Machine? Well, a Prismic slice is essentially a repeatable, reusable section of your site that's wired up to the Prismic CMS, and Slice Machine is a development environment that makes creating slices a breeze.

So in this demo lightning talk, we are going to be creating a slice with Slice Machine. We are going to be pushing that slice to Prismic. We're going to be filling in content in that slice, and then we're going to be pushing that slice out to production to update our website.

2. Adding a Map Slice and Starting Slice Machine UI

Short description:

Let's start by adding a slice to our existing Next.js website built out with Slice Machine. We'll create a map slice that shows the location, address, image, and heading. After creating the slice, we'll explore the generated files and start the Slice Machine UI. We'll remove the default content and create the slice from scratch, beginning with the heading.

So let's waste no more time, let's actually start by adding a slice to our existing Next.js website built out with Slice Machine. So as you can see here, I have this restaurant site, has a menu and a few other sections here. So let's check out the Figma file that this is based on. And as you can see, we've created slices from each of these parts. Each of these are slices here, and this is the slice that we're going to be adding today.

So it is a map slice that just basically shows the location of the place, the address and a couple other bits with an image and a heading. So let's go ahead, let's waste no time, let's jump into our terminal and create this slice. I'm going to run prismic sm create slice, just like that. And it's going to ask me where I would like this slice. And I say in my slices folder, and I call it location map, just like that. Great.

So now that we've created that slice, let's take a look at what we've just made with running that command. So here in location map, we have four files. index.js is a react component. Here we have a storybook story that's built for us already. Here in the mocs, we have some mock data that will fill in our story. And in the model, this shows the data structure. We'll come back to these in a second and see what changes once we edit them in the slice machine UI.

So I'm going to start up Slice Machine UI by running Prismic, SM, and then develop. And then this is going to start a local development server and kick off the slice machine UI. So let's head back over here. And right here, we see location map is next to all our other components. You might recognize these from our website. So let's go ahead in. Let's get rid of what it ships with by default and create this totally from scratch. So I'm looking at figma. I'm seeing that we've got pretty much four different types that we need to build out here. We have this heading, let's start with that. So I'm going to add a rich text field and call this heading. And I'm going to go in and I'm going to unselect all and make this just an H2, call it heading, just like that.

3. Adding Map Slice and Building Component

Short description:

I'm going to click Save. Next, we have this address. I'm going to hard code location, so we're going for address. I'm going to grab an image and label image. And then we need a geolocation because we have a map type here. So GeoPoint is going to allow us to do that. So I'm going to get location. That's what I'm going to call that. And for the mock config, I'm going to choose Prismic Headquarters. Our data has updated. The shape of this data has changed. So now we can start to build out our component now that we've defined the shape. I'm going to drop that in there. That's my heading. Here is my address. I'm going to grab my image. And then here for my location, I'm just going to paste that in and that is actually an object that has latitude and longitude on it. I'm going to show the latitude and let's check it out in storybook.

And I'm going to click Save. Next, we have this address. I'm going to hard code location, so we're going for address. I'm going to do a rich text field address just like that. Hit Enter and add a label here, just like that. And then we're going to grab this image. So we have all these different types to choose from. I'm going to grab an image and label image. Just like that. Cool. And then we need a geolocation because we have a map type here. So GeoPoint is going to allow us to do that. So I'm going to get location. That's what I'm going to call that. I'm going to come in here, give this a label. And for the mock config, I'm going to choose Prismic Headquarters. Just there. And now I save this model to file system and let's go check out what this looks like over here in our file system.

So we see that this was all added right away. Our data has updated. The shape of this data has changed. So now we can start to build out our component now that we've defined the shape so quick already. So heading over here to slices, I'm going to copy or I'm going to show code snippets that I can copy easily into my component. Click copy code on this heading and go over to my react component. Wipe out what's in here and I'm going to drop that in there. That's my heading. Here is my address and I'll style these in a minute. I'm going to grab my image, copy code, see I'm pasting in that image. And then here for my location, I'm just going to paste that in and that is actually an object that has latitude and longitude on it. I'm going to show the latitude and let's check it out in storybook.

4. Adding Location Map Slice

Short description:

I got storybook running. Let's check out our location map. We have our title, address, image, and latitude. Now I'm going to style it up. Added classes and map component. Hardcoded location text. Took a snapshot for the editor. Pushed slice to Prismic and code to GitHub. Added new slice as an option for editors. Now our editors know what they're grabbing. Added location map to the homepage. Let's fill it in with some content.

I got storybook running. It's already connected in. Let's check out our location map and boom, just like that. We have our title, our address, our image and our latitude. So all just default all mock so we can improve over time. But right now this is looking good.

So now I'm going to really quickly style this up a little bit. Let's see what we can do. All right, so we've skipped ahead to the styling. I've added some classes. I've also brought in this map component that I made that's expecting this location object. And I also hard coded in this location text and we just did some restructuring and styling. And now our component is looking much, much better looking just like that.

And so we are able to now take a snapshot that can be used for our editor. So we'll take a snapshot just like this. And so our editors can use that in Prismic. And there we have our snapshot looking great. Now we can go ahead and push our slice to Prismic so that we can use that in the CMS. And then I'm also going to push my code that we made with Slice Machine up to GitHub. So that Vercel can rebuild my next JS app. I'm going to say add location map slice, git push. And so now as that rebuilds, I'm going to head to my Prismic repository and I'm going to go into my custom types and add this new slice as an option for my editors to use.

So we see here in shared slices, these are the other slices that they've been able to use. And now we have our new location map with that snapshot. We can add that to our custom types and hit save. And so now our editors know exactly what they're grabbing when they come in to edit the homepage. So going into home and I can add this new slice anywhere between the other slices, I'm going to come all the way to the bottom now, because that's where this one's going. And I'm going to scroll over and there's our location map right there. So let's fill it in with some content. I've got a title here.

5. Publishing Changes and Rebuilding

Short description:

So after making the necessary adjustments, I hit the save button and published the changes. The webhook triggered a rebuild, and now we can see the updated components at the bottom.

So great story start with a great dinner. And we've got this address. I've got an image already uploaded that I can choose. And I have a latitude and longitude pasted here that we are going to use. Boom, right there. Now I'm going to hit save. And what I can do is Prismic has a great preview feature. So I could click production, but for the sake of this, we're going to skip ahead to publishing, but I could test it first and make sure that it's exactly how I want it to look. I can either publish it now or later. I'm going to publish it now, hitting publish and boom, just like that. It's going to trigger a rebuild and we're going to see what it looks like when we're done. So once we click publish, the webhook makes versell rebuild our page and here at the bottom, nice, looking great. There's our components.

Available in other languages:

Check out more articles and videos

We constantly think of articles and videos that might spark Git people interest / skill us up or help building a stellar career

A Guide to React Rendering Behavior

React Advanced 2022

25 min

A Guide to React Rendering Behavior

Top Content

Mark Erikson

Replay.io

This transcription provides a brief guide to React rendering behavior. It explains the process of rendering, comparing new and old elements, and the importance of pure rendering without side effects. It also covers topics such as batching and double rendering, optimizing rendering and using context and Redux in React. Overall, it offers valuable insights for developers looking to understand and optimize React rendering.

react performance deep dive react rendering

Building Better Websites with Remix

React Summit Remote Edition 2021

33 min

Building Better Websites with Remix

Top Content

Michael Jackson

React Training

Remix is a web framework built on React Router that focuses on web fundamentals, accessibility, performance, and flexibility. It delivers real HTML and SEO benefits, and allows for automatic updating of meta tags and styles. It provides features like login functionality, session management, and error handling. Remix is a server-rendered framework that can enhance sites with JavaScript but doesn't require it for basic functionality. It aims to create quality HTML-driven documents and is flexible for use with different web technologies and stacks.

react remix frameworks

React Compiler - Understanding Idiomatic React (React Forget)

React Advanced 2023

33 min

React Compiler - Understanding Idiomatic React (React Forget)

Top Content

Watch video: React Compiler - Understanding Idiomatic React (React Forget)

2 authors

The Talk discusses React Forget, a compiler built at Meta that aims to optimize client-side React development. It explores the use of memoization to improve performance and the vision of Forget to automatically determine dependencies at build time. Forget is named with an F-word pun and has the potential to optimize server builds and enable dead code elimination. The team plans to make Forget open-source and is focused on ensuring its quality before release.

react build tools builders and founders react 19 react forget

Using useEffect Effectively

React Advanced 2022

30 min

Using useEffect Effectively

Top Content

David Khourshid

Stately

Today's Talk explores the use of the useEffect hook in React development, covering topics such as fetching data, handling race conditions and cleanup, and optimizing performance. It also discusses the correct use of useEffect in React 18, the distinction between Activity Effects and Action Effects, and the potential misuse of useEffect. The Talk highlights the benefits of using useQuery or SWR for data fetching, the problems with using useEffect for initializing global singletons, and the use of state machines for handling effects. The speaker also recommends exploring the beta React docs and using tools like the stately.ai editor for visualizing state machines.

react best practices state management react hook missing dependency

Routing in React 18 and Beyond

React Summit 2022

20 min

Routing in React 18 and Beyond

Top Content

Delba de Oliveira

Senior Developer Advocate @ Vercel

Routing in React 18 brings a native app-like user experience and allows applications to transition between different environments. React Router and Next.js have different approaches to routing, with React Router using component-based routing and Next.js using file system-based routing. React server components provide the primitives to address the disadvantages of multipage applications while maintaining the same user experience. Improving navigation and routing in React involves including loading UI, pre-rendering parts of the screen, and using server components for more performant experiences. Next.js and Remix are moving towards a converging solution by combining component-based routing with file system routing.

react next.js patterns react file based routing

React Concurrency, Explained

React Summit 2023

23 min

React Concurrency, Explained

Top Content

Watch video: React Concurrency, Explained

Ivan Akulov

Google Developer Expert, Web Performance Consultant, Netherlands

React 18's concurrent rendering, specifically the useTransition hook, optimizes app performance by allowing non-urgent updates to be processed without freezing the UI. However, there are drawbacks such as longer processing time for non-urgent updates and increased CPU usage. The useTransition hook works similarly to throttling or bouncing, making it useful for addressing performance issues caused by multiple small components. Libraries like React Query may require the use of alternative APIs to handle urgent and non-urgent updates effectively.

react performance best practices react 18 deep dive react concurrent mode

Workshops on related topic

React Performance Debugging Masterclass

React Summit 2023

170 min

React Performance Debugging Masterclass

Top Content

Featured Workshop

Ivan Akulov

Ivan’s first attempts at performance debugging were chaotic. He would see a slow interaction, try a random optimization, see that it didn't help, and keep trying other optimizations until he found the right one (or gave up).
Back then, Ivan didn’t know how to use performance devtools well. He would do a recording in Chrome DevTools or React Profiler, poke around it, try clicking random things, and then close it in frustration a few minutes later. Now, Ivan knows exactly where and what to look for. And in this workshop, Ivan will teach you that too.
Here’s how this is going to work. We’ll take a slow app → debug it (using tools like Chrome DevTools, React Profiler, and why-did-you-render) → pinpoint the bottleneck → and then repeat, several times more. We won’t talk about the solutions (in 90% of the cases, it’s just the ol’ regular useMemo() or memo()). But we’ll talk about everything that comes before – and learn how to analyze any React performance problem, step by step.
(Note: This workshop is best suited for engineers who are already familiar with how useMemo() and memo() work – but want to get better at using the performance tools around React. Also, we’ll be covering interaction performance, not load speed, so you won’t hear a word about Lighthouse 🤐)

react performance best practices advanced debug react debugger react performance react profiler

Next.js for React.js Developers

React Day Berlin 2023

157 min

Next.js for React.js Developers

Top Content

Featured WorkshopFree

Adrian Hajdin

In this advanced Next.js workshop, we will delve into key concepts and techniques that empower React.js developers to harness the full potential of Next.js. We will explore advanced topics and hands-on practices, equipping you with the skills needed to build high-performance web applications and make informed architectural decisions.
By the end of this workshop, you will be able to:1. Understand the benefits of React Server Components and their role in building interactive, server-rendered React applications.2. Differentiate between Edge and Node.js runtime in Next.js and know when to use each based on your project's requirements.3. Explore advanced Server-Side Rendering (SSR) techniques, including streaming, parallel vs. sequential fetching, and data synchronization.4. Implement caching strategies for enhanced performance and reduced server load in Next.js applications.5. Utilize React Actions to handle complex server mutation.6. Optimize your Next.js applications for SEO, social sharing, and overall performance to improve discoverability and user engagement.

react nextjs react

Concurrent Rendering Adventures in React 18

React Advanced 2021

132 min

Concurrent Rendering Adventures in React 18

Top Content

Featured Workshop

Maurice de Beijer

With the release of React 18 we finally get the long awaited concurrent rendering. But how is that going to affect your application? What are the benefits of concurrent rendering in React? What do you need to do to switch to concurrent rendering when you upgrade to React 18? And what if you don’t want or can’t use concurrent rendering yet?

There are some behavior changes you need to be aware of! In this workshop we will cover all of those subjects and more.

Join me with your laptop in this interactive workshop. You will see how easy it is to switch to concurrent rendering in your React application. You will learn all about concurrent rendering, SuspenseList, the startTransition API and more.

react concurrent rendering react 18 react concurrent mode react suspense

React Hooks Tips Only the Pros Know

React Summit Remote Edition 2021

177 min

React Hooks Tips Only the Pros Know

Top Content

Featured Workshop

Maurice de Beijer

The addition of the hooks API to React was quite a major change. Before hooks most components had to be class based. Now, with hooks, these are often much simpler functional components. Hooks can be really simple to use. Almost deceptively simple. Because there are still plenty of ways you can mess up with hooks. And it often turns out there are many ways where you can improve your components a better understanding of how each React hook can be used.You will learn all about the pros and cons of the various hooks. You will learn when to use useState() versus useReducer(). We will look at using useContext() efficiently. You will see when to use useLayoutEffect() and when useEffect() is better.

react best practices react hooks deep dive react 18 hooks react profiler

Introducing FlashList: Let's build a performant React Native list all together

React Advanced 2022

81 min

Introducing FlashList: Let's build a performant React Native list all together

Top Content

Featured Workshop

3 authors

In this workshop you’ll learn why we created FlashList at Shopify and how you can use it in your code today. We will show you how to take a list that is not performant in FlatList and make it performant using FlashList with minimum effort. We will use tools like Flipper, our own benchmarking code, and teach you how the FlashList API can cover more complex use cases and still keep a top-notch performance.You will know:- Quick presentation about what FlashList, why we built, etc.- Migrating from FlatList to FlashList- Teaching how to write a performant list- Utilizing the tools provided by FlashList library (mainly the useBenchmark hook)- Using the Flipper plugins (flame graph, our lists profiler, UI & JS FPS profiler, etc.)- Optimizing performance of FlashList by using more advanced props like `getType`- 5-6 sample tasks where we’ll uncover and fix issues together- Q&A with Shopify team

react react native react native flashlist

React, TypeScript, and TDD

React Advanced 2021

174 min

React, TypeScript, and TDD

Top Content

Featured Workshop

Paul Everitt

ReactJS is wildly popular and thus wildly supported. TypeScript is increasingly popular, and thus increasingly supported.

The two together? Not as much. Given that they both change quickly, it's hard to find accurate learning materials.

React+TypeScript, with JetBrains IDEs? That three-part combination is the topic of this series. We'll show a little about a lot. Meaning, the key steps to getting productive, in the IDE, for React projects using TypeScript. Along the way we'll show test-driven development and emphasize tips-and-tricks in the IDE.

react best practices typescript devtools web development test driven development react