Home
Welcome to the Scarpe wiki!
Scarpe is a reimplementation of Shoes using Webview and a modular backend. Shoes is a friendly little Ruby-based API. It's designed to make UI apps, full of windows and lists and text, in the same way that Ruby on Rails is designed to make web applications that run on a server and use a browser.
- Nick Schwaderer gave a great introduction to Shoes and Scarpe at Brighton Ruby 2023
- There's a great starter Shoes Manual in the Scarpe Git repo
- _why wrote a great book about Shoes called Nobody Knows Shoes (you'll need to download it and read it locally, GitHub won't display it)
- There are Shoes and Scarpe API Docs generated from the Scarpe Git repo. The Shoes module is a good place to start looking around.
- A September video walkthrough of the Scarpe code
Scarpe can do many things old Shoes did, and some that it never could. But if you're just getting started, what works and what doesn't? Check the Getting-Started Map.
"Where do I start? What's a good first issue?" Glad you asked!
Some eternal good first issues:
- Write tests!
- Write applications!
- Get examples to work!
- Write documentation!
- Fix bugs! - for this you can jump right in or check the good first issue tag
Eventually you can get into all kinds of interesting things. Make progress on getting Hackety-Hack running? Write a new display service? Get a new platform working? Make progress in a major direction? Up to you.
- Scarpe Architecture - how does Scarpe work underneath?
- Feature Brainstorming - what do we want to add to Scarpe eventually?
Why Shoes? Why Scarpe? Why _why?