Skip to content
publik.
Browse appsBrowsePricing
+Publish a repoPublish
Browse appsHow it worksPublish a repoGet helpPricingDevelopersGitHubPrivacy
© 2026 publik
All apps/Potluck/Install/macOS

How to install Potluck on Mac

Potluck does what Google Tabletop does, and Google Tabletop costs Paid. This guide gets you the free one.

What you end up with

Potluck running in your browser, on your own computer. It is free, and it stays free. It opens with Sign in with publik; no trial, no subscription.

Time
About 28 minutes
Steps
11
Cost
Free

Read this first

Assembled from the submission questionnaire with zero model calls. No founder has reviewed this guide yet.

Before you start

These are one-time installs. If you have used Terminal before, you may have them already — the first step checks.

  1. 1

    Install Git

    Apple opens a small installer.

    Type this into Terminal, then press Return.

    xcode-select --install

    You know this worked when: Git responds with a version number

  2. 2

    Install Node LTS

    Choose the macOS Installer (.pkg).

    Open download ↗

    You know this worked when: Node responds with a version number

Install Potluck

  1. 3

    Open Terminal

    Keep it open beside this page.

    You know this worked when: Terminal is open

  2. 4

    Check Git and Node

    Git and the current Node LTS are required.

    Type this into Terminal, then press Return.

    git --version
    node --version

    You know this worked when: Git and Node respond with version numbers

  3. 5

    Copy Potluck to this Mac

    Type this into Terminal, then press Return. The first line moves you into the folder this step runs in, so it works in a window you have just opened.

    cd ~
    if [ ! -d potluck/.git ]; then
    git clone https://github.com/VedSoni-dev/potluck.git
    fi

    You know this worked when: A potluck folder appears

  4. 6

    Open the Potluck folder

    Type this into Terminal, then press Return. The first line moves you into the folder this step runs in, so it works in a window you have just opened.

    cd ~
    cd potluck

    You know this worked when: Your terminal prompt is inside the potluck folder

  5. 7

    Use the reviewed version

    Type this into Terminal, then press Return. The first line moves you into the folder this step runs in, so it works in a window you have just opened.

    cd ~/potluck
    git checkout ccaffae6c7d2658df34b522a55b9de32b38d83af

    You know this worked when: Git reports the reviewed commit

  6. 8

    Install dependencies

    Type this into Terminal, then press Return. The first line moves you into the folder this step runs in, so it works in a window you have just opened.

    cd ~/potluck
    npm install

    You know this worked when: The command finishes without an error

  7. 9

    Run Potluck

    Keep Terminal open.

    Type this into Terminal, then press Return. The first line moves you into the folder this step runs in, so it works in a window you have just opened.

    cd ~/potluck
    npm run dev

    You know this worked when: localhost:3000 responds

  8. 10

    Open it in your browser

    If a different port was picked, open that one instead.

    Open localhost:3000 ↗

    You know this worked when: The app loads in the browser

  9. 11

    Try it

    Potluck should be open in your browser.

    You know this worked when: Potluck works

If something goes wrong

Nothing here can damage your computer, and every step can be run again safely. If a command fails, the usual cause is the step before it not having finished.

Still stuck? Tell us what happened and we will fix the guide. Include the step number and we can usually reproduce it.

Have a different setup?

  • How to install Potluck on Windows →

This guide follows VedSoni-dev/potluck at the reviewed version ccaffae. Pinning the version is why the commands here keep working after the project changes.

Back to Potluck →