whatisgithub

What is riddle-ipad?

trentct/riddle-ipad — explained in plain English

Analysis updated 2026-05-18

14SwiftAudience · vibe coderComplexity · 3/5LicenseSetup · moderate

In one sentence

An iPad app where you write with Apple Pencil and an AI writes back in realistic flowing handwriting, like a magic diary.

Mindmap

mindmap
  root((Riddle iPad))
    What it does
      Ink drinking diary
      Handwritten AI replies
      No chat UI
    Tech stack
      Swift
      PencilKit
      XcodeGen
    Use cases
      Novelty diary app
      Handwriting synthesis demo
      Vision AI prototype
    Audience
      Vibe coders
      iOS tinkerers
    Setup
      Needs iPad and Pencil
      Needs vision API key

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Build a novelty diary app that replies to handwritten notes in matching handwriting.

USE CASE 2

Learn how to convert AI text replies into animated, realistic pen stroke paths.

USE CASE 3

Prototype a vision AI app that reads handwritten pages as images.

USE CASE 4

Explore font agnostic handwriting synthesis for multiple languages.

What is it built with?

SwiftXcodePencilKitXcodeGenOpenAI API

How does it compare?

trentct/riddle-ipadhunters1431/mackeytnt-likely/panbar
Stars141414
LanguageSwiftSwiftSwift
Setup difficultymoderateeasyeasy
Complexity3/52/52/5
Audiencevibe codergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs a physical iPad with Apple Pencil, Xcode, and an API key for a vision-capable AI model.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

Riddle iPad turns your tablet into a version of Tom Riddle's diary from the Harry Potter stories. You write on the screen with an Apple Pencil, the page appears to soak up your ink, and after you rest the pen for a moment an answer writes itself back in flowing handwriting, one stroke at a time, before fading away. There is no chat window, no buttons, and no keyboard involved. The whole experience is just ink appearing on paper. This project is an iPad version of an existing app called Riddle, which was originally built for the reMarkable tablet. The handwriting generation system and the diary personality both come from that original project, and this repository focuses on porting the idea to iPadOS with Apple Pencil support. Under the hood, your pencil strokes are captured with Apple's PencilKit framework. When you pause writing for a couple of seconds, the page is turned into an image and sent to a vision capable AI model that understands both text and pictures. The model writes its reply, and that reply is converted into realistic pen strokes using a font rendering and thinning process, then animated onto the screen so it looks like it is being handwritten in real time, at a natural pace. The system works with any font, so it can reply in cursive style English or in a handwritten Chinese script, always matching whatever language you wrote in. To run this project yourself you need a Mac with Xcode, a physical iPad running iPadOS 17 or later with Apple Pencil support, and an API key for any AI service that offers a vision capable chat model compatible with the OpenAI API format. The default setup points to a provider called Moonshot, but you can swap in a different one by editing a configuration file. Setup involves installing a tool called XcodeGen, generating the Xcode project, adding your API key to a config file, then building and running the app directly on your iPad. The project is released under the MIT license, and credits the original algorithm, diary concept, and fonts used to their respective creators.

Copy-paste prompts

Prompt 1
Explain how PencilKit captures pen strokes and converts a page into an image for this project.
Prompt 2
Help me set up XcodeGen and generate the Xcode project for Riddle-iPad.
Prompt 3
Show me how to swap the default Moonshot vision model for a different OpenAI-compatible provider in Secrets.xcconfig.
Prompt 4
Walk me through how the handwriting synthesis pipeline turns AI text into animated pen strokes.
Prompt 5
Help me add a new font so the diary can reply in a different handwriting style.

Frequently asked questions

What is riddle-ipad?

An iPad app where you write with Apple Pencil and an AI writes back in realistic flowing handwriting, like a magic diary.

What language is riddle-ipad written in?

Mainly Swift. The stack also includes Swift, Xcode, PencilKit.

What license does riddle-ipad use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is riddle-ipad to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is riddle-ipad for?

Mainly vibe coder.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.