Handshake - Simple Agreements

AI powered digital handshake for real-world deals

Comment

Handshake Legal

Leightweight agreement, with AI quietly watching your back

TL;DR

Handshake Legal is a simple way to create and accept everyday agreements—without lawyers, PDFs, or legal intimidation. AI helps make sure your terms are actually complete, so you can focus on the human part of the deal.

The Concept

A lot of real agreements never get written down.

Not because they don’t matter—but because the process feels awkward, heavy, or way too "legal" for the situation.

You're collaborating on a side project.
You're trading services.
You're doing a one-off freelance job.

Most of the time, you don’t want a lawyer or a 10-page contract.
You just want clarity and mutual intent.

Handshake Legal explores what agreements could feel like if they were approachable, human, and fast—while still being meaningful.

The twist is a quiet AI superpower that helps without getting in the way.

Handshake deals usually fall apart for one simple reason:
something important was never said.

As you write an agreement in plain language, AI reviews it to help catch those moments before you send it:

  • Flags missing terms
  • Highlights ambiguous responsibilities
  • Calls out unclear timelines or expectations
  • Surfaces "this might be misunderstood later" gaps

The goal is simple: help you list the full terms of the deal so you can stay lightweight and move fast.

AI handles the completeness check.
You handle the relationship.

What It Does

Handshake Legal lets you:

  • Write a simple agreement in plain language
  • Get AI feedback to ensure your terms are complete and clear
  • Share the agreement via a private link
  • Let the other party review and accept with a digital handshake
  • Finalize a lightweight agreement—no emails or PDFs

It's designed for everyday moments where "we're aligned" actually matters.

How It Works

  1. Create an offer
  2. AI checks for clarity and completeness
  3. Share a private link
  4. The other party reviews and accepts
  5. The agreement is sealed

How It's Built

Handshake Legal is a full-stack TypeScript + Next.js application, built with modern tooling so it's fast to ship and easy to iterate on.

Core Stack

  • Next.js (App Router + React)
    Uses Server Components for fast page loads and Client Components for interactivity.

  • TypeScript
    End-to-end type safety to keep the codebase reliable and maintainable.

UI & Design

  • ShadCN/UI
    Used for cards, buttons, inputs, and forms—clean, accessible, and production-ready.

  • Tailwind CSS
    Utility-first styling for rapid iteration and consistent design.

  • Lucide React
    Simple, readable icons throughout the interface.

Data & App Logic

  • In-memory mock data
    Used for rapid prototyping to validate the full user flow without backend complexity.

  • Next.js Server Actions
    Data mutations handled with use server, removing the need for separate API routes.

AI Implementation

  • Built with Genkit, Google’s open-source framework for generative AI
  • Powered by Gemini
  • Feedback-only analysis—no rewriting, no added legal language

The AI exists to support clearer communication, not replace it.

Development Workflow

This project was built using Firebase Studio, with AI-assisted "vibe coding" powered by Gemini.

  • Initial prototype in Stitch by Google then sent screenshots to Firebase Studio
  • Code written locally and directly in the Firebase IDE
  • Version control via GitHub
  • Public repository, fully forkable

This setup made it easy to focus on product thinking instead of infrastructure.

What This Project Explores

  • How lightweight agreements can feel less intimidating
  • How AI can help people communicate clearly without overstepping
  • How UX decisions influence trust
  • How modern full-stack tooling lowers the barrier to shipping real products

Try It / Fork It

Handshake Legal is open source.

View the repository on GitHub:
https://github.com/jdanjohnson/handshake

Built With

Next.js, React, TypeScript, Firebase, Firebase Studio, Genkit, Gemini, ShadCN/UI, Tailwind CSS, Lucide React, GitHub

Built With

  • nextjs
Share this project:

Updates