Yappybara

Yappybara is a local-first AI app ideation and prototyping workspace.

It gives you a fast loop:

1. chat through an app idea,
2. shape the spec,
3. generate a working prototype,
4. iterate.

Positioning

• Engineer-focused
• Local-first
• Free to use locally
• No required hosted backend

This repository intentionally does not depend on Fly.io or a paid hosted API layer for the core workflow.

Why this is cheap

• interview-app/ runs locally on your machine
• Data stays in local files (interview-app/data/, interview-app/apps.json)
• GitHub Pages hosts site/ for free
• Domain can be pointed with standard DNS records (no app hosting bill)

Quick Start

git clone https://github.com/obsecurus/yappybara.git
cd yappybara
make interview-setup
make interview-demo

Then open http://localhost:3456.

For full Claude-backed mode:

make interview

Runtime modes

• YAPPY_MODE=auto (default): Claude first, fallback to local demo
• YAPPY_MODE=claude: require Claude
• YAPPY_MODE=demo: local-only demo mode

Main commands

make interview-setup    # install interview-app dependencies
make interview          # start full mode (Claude)
make interview-demo     # start local-only mode
make interview-test     # run interview-app tests

GitHub Pages (yappybara.dev)

The public site is in site/ and deploys via .github/workflows/pages.yml.

Setup guide:

• docs/github-pages.md

Repository layout

interview-app/              # local app server + UI
site/                       # static marketing/docs site for GitHub Pages
scripts/                    # setup + DNS helper scripts
.github/workflows/          # CI + Pages deploy workflow
assets/brand/               # logo assets

Tests

cd interview-app
node --check server.js builder.js mechanic.js safety.js
AUTO_GENERATE_CERTS=false node --test test.js

License

MIT