adrianhajdin / figma_clone

Figma Clone using Next.js, Fabric.js and Liveblocks in TypeScript
https://jsmastery.pro
1k stars 259 forks source link
figma liveblocks nextjs14

Project Banner
typescript nextdotjs tailwindcss

Real Time Figma Clone

Build this project step by step with our detailed tutorial on JavaScript Mastery YouTube. Join the JSM family!

πŸ“‹ Table of Contents

  1. πŸ€– Introduction
  2. βš™οΈ Tech Stack
  3. πŸ”‹ Features
  4. 🀸 Quick Start
  5. πŸ•ΈοΈ Snippets
  6. πŸ”— Links
  7. πŸš€ More

🚨 Tutorial

This repository contains the code corresponding to an in-depth tutorial available on our YouTube channel, JavaScript Mastery.

If you prefer visual learning, this is the perfect resource for you. Follow our tutorial to learn how to build projects like these step-by-step in a beginner-friendly manner!

πŸ€– Introduction

A minimalistic Figma clone to show how to add real-world features like live collaboration with cursor chat, comments, reactions, and drawing designs (shapes, image upload) on the canvas using fabric.js.

If you're getting started and need assistance or face any bugs, join our active Discord community with over 27k+ members. It's a place where people help each other out.

βš™οΈ Tech Stack

πŸ”‹ Features

πŸ‘‰ Multi Cursors, Cursor Chat, and Reactions: Allows multiple users to collaborate simultaneously by showing individual cursors, enabling real-time chat, and reactions for interactive communication.

πŸ‘‰ Active Users: Displays a list of currently active users in the collaborative environment, providing visibility into who is currently engaged.

πŸ‘‰ Comment Bubbles: Enables users to attach comments to specific elements on the canvas, fostering communication and feedback on design components.

πŸ‘‰ Creating Different Shapes: Provides tools for users to generate a variety of shapes on the canvas, allowing for diverse design elements

πŸ‘‰ Uploading Images: Import images onto the canvas, expanding the range of visual content in the design

πŸ‘‰ Customization: Allows users to adjust the properties of design elements, offering flexibility in customizing and fine-tuning visual components

πŸ‘‰ Freeform Drawing: Enables users to draw freely on the canvas, promoting artistic expression and creative design.

πŸ‘‰ Undo/Redo: Provides the ability to reverse (undo) or restore (redo) previous actions, offering flexibility in design decision-making

πŸ‘‰ Keyboard Actions: Allows users to utilize keyboard shortcuts for various actions, including copying, pasting, deleting, and triggering shortcuts for features like opening cursor chat, reactions, and more, enhancing efficiency and accessibility.

πŸ‘‰ History: Review the chronological history of actions and changes made on the canvas, aiding in project management and version control.

πŸ‘‰ Deleting, Scaling, Moving, Clearing, Exporting Canvas: Offers a range of functions for managing design elements, including deletion, scaling, moving, clearing the canvas, and exporting the final design for external use.

and many more, including code architecture, advanced react hooks, and reusability

🀸 Quick Start

Follow these steps to set up the project locally on your machine.

Prerequisites

Make sure you have the following installed on your machine:

Cloning the Repository

git clone https://github.com/JavaScript-Mastery-Pro/figma-ts.git
cd figma-ts

Installation

Install the project dependencies using npm:

npm install

Set Up Environment Variables

Create a new file named .env.local in the root of your project and add the following content:

NEXT_PUBLIC_LIVEBLOCKS_PUBLIC_KEY=

Replace the placeholder values with your actual Liveblocks credentials. You can obtain these credentials by signing up on the Liveblocks website.

Running the Project

npm run dev

Open http://localhost:3000 in your browser to view the project.

πŸ•ΈοΈ Snippets

Styles

tailwind.config.ts ```typescript import type { Config } from "tailwindcss"; const config = { darkMode: ["class"], content: [ "./pages/**/*.{ts,tsx}", "./components/**/*.{ts,tsx}", "./app/**/*.{ts,tsx}", "./src/**/*.{ts,tsx}", ], prefix: "", theme: { container: { center: true, padding: "2rem", screens: { "2xl": "1400px", }, }, extend: { colors: { primary: { black: "#14181F", green: "#56FFA6", grey: { 100: "#2B303B", 200: "#202731", 300: "#C4D3ED", }, }, }, keyframes: { "accordion-down": { from: { height: "0" }, to: { height: "var(--radix-accordion-content-height)" }, }, "accordion-up": { from: { height: "var(--radix-accordion-content-height)" }, to: { height: "0" }, }, }, animation: { "accordion-down": "accordion-down 0.2s ease-out", "accordion-up": "accordion-up 0.2s ease-out", }, }, }, plugins: [require("tailwindcss-animate")], } satisfies Config; export default config; ```
app/globals.css ```css @tailwind base; @tailwind components; @tailwind utilities; @import "@liveblocks/react-comments/styles.css"; * { font-family: work sans, sans-serif; } @layer utilities { .no-ring { @apply outline-none ring-0 ring-offset-0 focus:ring-0 focus:ring-offset-0 focus-visible:ring-offset-0 !important; } .input-ring { @apply h-8 rounded-none border-none bg-transparent outline-none ring-offset-0 focus:ring-1 focus:ring-primary-green focus:ring-offset-0 focus-visible:ring-offset-0 !important; } .right-menu-content { @apply flex w-80 flex-col gap-y-1 border-none bg-primary-black py-4 text-white !important; } .right-menu-item { @apply flex justify-between px-3 py-2 hover:bg-primary-grey-200 !important; } } ```

Overlay Comments

NewThread ```tsx "use client"; import { FormEvent, ReactNode, useCallback, useEffect, useRef, useState, } from "react"; import { Slot } from "@radix-ui/react-slot"; import * as Portal from "@radix-ui/react-portal"; import { ComposerSubmitComment } from "@liveblocks/react-comments/primitives"; import { useCreateThread } from "@/liveblocks.config"; import { useMaxZIndex } from "@/lib/useMaxZIndex"; import PinnedComposer from "./PinnedComposer"; import NewThreadCursor from "./NewThreadCursor"; type ComposerCoords = null | { x: number; y: number }; type Props = { children: ReactNode; }; export const NewThread = ({ children }: Props) => { // set state to track if we're placing a new comment or not const [creatingCommentState, setCreatingCommentState] = useState< "placing" | "placed" | "complete" >("complete"); /** * We're using the useCreateThread hook to create a new thread. * * useCreateThread: https://liveblocks.io/docs/api-reference/liveblocks-react#useCreateThread */ const createThread = useCreateThread(); // get the max z-index of a thread const maxZIndex = useMaxZIndex(); // set state to track the coordinates of the composer (liveblocks comment editor) const [composerCoords, setComposerCoords] = useState(null); // set state to track the last pointer event const lastPointerEvent = useRef(); // set state to track if user is allowed to use the composer const [allowUseComposer, setAllowUseComposer] = useState(false); const allowComposerRef = useRef(allowUseComposer); allowComposerRef.current = allowUseComposer; useEffect(() => { // If composer is already placed, don't do anything if (creatingCommentState === "complete") { return; } // Place a composer on the screen const newComment = (e: MouseEvent) => { e.preventDefault(); // If already placed, click outside to close composer if (creatingCommentState === "placed") { // check if the click event is on/inside the composer const isClickOnComposer = ((e as any)._savedComposedPath = e .composedPath() .some((el: any) => { return el.classList?.contains("lb-composer-editor-actions"); })); // if click is inisde/on composer, don't do anything if (isClickOnComposer) { return; } // if click is outside composer, close composer if (!isClickOnComposer) { setCreatingCommentState("complete"); return; } } // First click sets composer down setCreatingCommentState("placed"); setComposerCoords({ x: e.clientX, y: e.clientY, }); }; document.documentElement.addEventListener("click", newComment); return () => { document.documentElement.removeEventListener("click", newComment); }; }, [creatingCommentState]); useEffect(() => { // If dragging composer, update position const handlePointerMove = (e: PointerEvent) => { // Prevents issue with composedPath getting removed (e as any)._savedComposedPath = e.composedPath(); lastPointerEvent.current = e; }; document.documentElement.addEventListener("pointermove", handlePointerMove); return () => { document.documentElement.removeEventListener( "pointermove", handlePointerMove ); }; }, []); // Set pointer event from last click on body for use later useEffect(() => { if (creatingCommentState !== "placing") { return; } const handlePointerDown = (e: PointerEvent) => { // if composer is already placed, don't do anything if (allowComposerRef.current) { return; } // Prevents issue with composedPath getting removed (e as any)._savedComposedPath = e.composedPath(); lastPointerEvent.current = e; setAllowUseComposer(true); }; // Right click to cancel placing const handleContextMenu = (e: Event) => { if (creatingCommentState === "placing") { e.preventDefault(); setCreatingCommentState("complete"); } }; document.documentElement.addEventListener("pointerdown", handlePointerDown); document.documentElement.addEventListener("contextmenu", handleContextMenu); return () => { document.documentElement.removeEventListener( "pointerdown", handlePointerDown ); document.documentElement.removeEventListener( "contextmenu", handleContextMenu ); }; }, [creatingCommentState]); // On composer submit, create thread and reset state const handleComposerSubmit = useCallback( ({ body }: ComposerSubmitComment, event: FormEvent) => { event.preventDefault(); event.stopPropagation(); // Get your canvas element const overlayPanel = document.querySelector("#canvas"); // if there's no composer coords or last pointer event, meaning the user hasn't clicked yet, don't do anything if (!composerCoords || !lastPointerEvent.current || !overlayPanel) { return; } // Set coords relative to the top left of your canvas const { top, left } = overlayPanel.getBoundingClientRect(); const x = composerCoords.x - left; const y = composerCoords.y - top; // create a new thread with the composer coords and cursor selectors createThread({ body, metadata: { x, y, resolved: false, zIndex: maxZIndex + 1, }, }); setComposerCoords(null); setCreatingCommentState("complete"); setAllowUseComposer(false); }, [createThread, composerCoords, maxZIndex] ); return ( <> {/** * Slot is used to wrap the children of the NewThread component * to allow us to add a click event listener to the children * * Slot: https://www.radix-ui.com/primitives/docs/utilities/slot * * Disclaimer: We don't have to download this package specifically, * it's already included when we install Shadcn */} setCreatingCommentState( creatingCommentState !== "complete" ? "complete" : "placing" ) } style={{ opacity: creatingCommentState !== "complete" ? 0.7 : 1 }} > {children} {/* if composer coords exist and we're placing a comment, render the composer */} {composerCoords && creatingCommentState === "placed" ? ( /** * Portal.Root is used to render the composer outside of the NewThread component to avoid z-index issuess * * Portal.Root: https://www.radix-ui.com/primitives/docs/utilities/portal */ ) : null} {/* Show the customizing cursor when placing a comment. The one with comment shape */} ); }; ```
PinnedComposer ```tsx "use client"; import Image from "next/image"; import { Composer, ComposerProps } from "@liveblocks/react-comments"; type Props = { onComposerSubmit: ComposerProps["onComposerSubmit"]; }; const PinnedComposer = ({ onComposerSubmit, ...props }: Props) => { return (
someone
{/** * We're using the Composer component to create a new comment. * Liveblocks provides a Composer component that allows to * create/edit/delete comments. * * Composer: https://liveblocks.io/docs/api-reference/liveblocks-react-comments#Composer */} { e.stopPropagation() }} />
); }; export default PinnedComposer; ```
NewThreadCursor ```tsx "use client"; import { useEffect, useState } from "react"; import * as Portal from "@radix-ui/react-portal"; const DEFAULT_CURSOR_POSITION = -10000; // display a custom cursor when placing a new thread const NewThreadCursor = ({ display }: { display: boolean }) => { const [coords, setCoords] = useState({ x: DEFAULT_CURSOR_POSITION, y: DEFAULT_CURSOR_POSITION, }); useEffect(() => { const updatePosition = (e: MouseEvent) => { // get canvas element const canvas = document.getElementById("canvas"); if (canvas) { /** * getBoundingClientRect returns the size of an element and its position relative to the viewport * * getBoundingClientRect: https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect */ const canvasRect = canvas.getBoundingClientRect(); // check if the mouse is outside the canvas // if so, hide the custom comment cursor if ( e.clientX < canvasRect.left || e.clientX > canvasRect.right || e.clientY < canvasRect.top || e.clientY > canvasRect.bottom ) { setCoords({ x: DEFAULT_CURSOR_POSITION, y: DEFAULT_CURSOR_POSITION, }); return; } } // set the coordinates of the cursor setCoords({ x: e.clientX, y: e.clientY, }); }; document.addEventListener("mousemove", updatePosition, false); document.addEventListener("mouseenter", updatePosition, false); return () => { document.removeEventListener("mousemove", updatePosition); document.removeEventListener("mouseenter", updatePosition); }; }, []); useEffect(() => { if (display) { document.documentElement.classList.add("hide-cursor"); } else { document.documentElement.classList.remove("hide-cursor"); } }, [display]); if (!display) { return null; } return ( // Portal.Root is used to render a component outside of its parent component
); }; export default NewThreadCursor; ```
CommentsOverlay ```tsx "use client"; import { useCallback, useRef } from "react"; import { ThreadData } from "@liveblocks/client"; import { ThreadMetadata, useEditThreadMetadata, useThreads, useUser } from "@/liveblocks.config"; import { useMaxZIndex } from "@/lib/useMaxZIndex"; import { PinnedThread } from "./PinnedThread"; type OverlayThreadProps = { thread: ThreadData; maxZIndex: number; }; export const CommentsOverlay = () => { /** * We're using the useThreads hook to get the list of threads * in the room. * * useThreads: https://liveblocks.io/docs/api-reference/liveblocks-react#useThreads */ const { threads } = useThreads(); // get the max z-index of a thread const maxZIndex = useMaxZIndex(); return (
{threads .filter((thread) => !thread.metadata.resolved) .map((thread) => ( ))}
); }; const OverlayThread = ({ thread, maxZIndex }: OverlayThreadProps) => { /** * We're using the useEditThreadMetadata hook to edit the metadata * of a thread. * * useEditThreadMetadata: https://liveblocks.io/docs/api-reference/liveblocks-react#useEditThreadMetadata */ const editThreadMetadata = useEditThreadMetadata(); /** * We're using the useUser hook to get the user of the thread. * * useUser: https://liveblocks.io/docs/api-reference/liveblocks-react#useUser */ const { isLoading } = useUser(thread.comments[0].userId); // We're using a ref to get the thread element to position it const threadRef = useRef(null); // If other thread(s) above, increase z-index on last element updated const handleIncreaseZIndex = useCallback(() => { if (maxZIndex === thread.metadata.zIndex) { return; } // Update the z-index of the thread in the room editThreadMetadata({ threadId: thread.id, metadata: { zIndex: maxZIndex + 1, }, }); }, [thread, editThreadMetadata, maxZIndex]); if (isLoading) { return null; } return (
{/* render the thread */}
); }; ```
PinnedThread ```tsx "use client"; import Image from "next/image"; import { useMemo, useState } from "react"; import { ThreadData } from "@liveblocks/client"; import { Thread } from "@liveblocks/react-comments"; import { ThreadMetadata } from "@/liveblocks.config"; type Props = { thread: ThreadData; onFocus: (threadId: string) => void; }; export const PinnedThread = ({ thread, onFocus, ...props }: Props) => { // Open pinned threads that have just been created const startMinimized = useMemo( () => Number(new Date()) - Number(new Date(thread.createdAt)) > 100, [thread] ); const [minimized, setMinimized] = useState(startMinimized); /** * memoize the result of this function so that it doesn't change on every render but only when the thread changes * Memo is used to optimize performance and avoid unnecessary re-renders. * * useMemo: https://react.dev/reference/react/useMemo */ const memoizedContent = useMemo( () => (
{ onFocus(thread.id); // check if click is on/in the composer if ( e.target && e.target.classList.contains("lb-icon") && e.target.classList.contains("lb-button-icon") ) { return; } setMinimized(!minimized); }} >
Dummy Name
{!minimized ? (
{ e.stopPropagation(); }} />
) : null}
), [thread.comments.length, minimized] ); return <>{memoizedContent}; }; ```

πŸ”— Links

πŸš€ More

Advance your skills with Next.js 14 Pro Course

Enjoyed creating this project? Dive deeper into our PRO courses for a richer learning adventure. They're packed with detailed explanations, cool features, and exercises to boost your skills. Give it a go!

Project Banner



Accelerate your professional journey with the Expert Training program

And if you're hungry for more than just a course and want to understand how we learn and tackle tech challenges, hop into our personalized masterclass. We cover best practices, different web skills, and offer mentorship to boost your confidence. Let's learn and grow together!

Project Banner

#