KLY5ZP3NCLTXI5OPVHXI7HVYEU6TDC6W22PKYVRBZXX7MLAKIF5AC
2534RME66Q5DGMUO5DK3TVQBAJ46UX2M64VE3BYSPXI6ECEF2HHAC
GWY3MDWPCK5HDGEEV52OHEFIURO6ZUNCHVBYZ6NZCYHLI35GDYBQC
PK25ETNWXWCMDGF5HJT3OGT6IYIEXMOIGVJEKWY2RTFZL37NDSHAC
4VUVVW6JTJU63US5YQPERLU7RREWDJCTGCKICLQVVASIAYQAO4ZQC
FS2ITYYHBLFT66YUC3ENPFYI2HOYHOVEPQIN7NQR6KF5MEK4NKZAC
FSQ7OI4M7DRTLNCLZMPVNMMOMRD2HHF3TGN2RTURPNIEHNLHA24QC
MD3W5IRAC6UQALQE4LJC52VQNDO3I3HXF3XE2XHDABXBYJBUVAXQC
WKJYU3EPP6SUJ4QKHCXEYNKPTWIVF6Z2GJT5B5VERJMNGBELDECAC
UOGZZY3LDQMFV5225YHIOQLKY4443TBYFIA6AWB7TGUUZWRIHEYQC
QKFHDM6JBO7SLLY4QNZO4KCLXAG2YS2H7L5PBYTDMPACNNWYG4QAC
AMYOQ4QWPDR7QOSMVVIJ5X7ZRABNMSKYVTRWDEPGTAXHQDJYHYQAC
3WSB7ZTVUSESQ4SVULMTICV3ABXICYZH7QQ7MH5NPVBDYYORJVDAC
ZTMRQZSWUL6FJRI4C4H37MR2IMV22DB6KRGEOUNYRWW5CTAVQFKAC
D4FEFHQCSILZFQ5VLWNXAIRZNUMCDNGJSM4UJ6T6FDMMIWYRYILQC
KSL52BPSQJ7AW2WALWQDKPL2YCSEQUWS5MG24WO6FHBJAIP75E5AC
Copy this repo to get a leg up creating tiny, low-maintenance, cross-platform
apps that you can make changes to right on a phone or tablet.
It comes bundled with a few optional goodies:
* Support for tap-to-pan and pinch-to-zoom gestures over an infinite 2D
surface for arbitrary graphics and UI.
* A tiny widget library for quickly creating arbitrary UI elements.
[Here's an example of the kinds of things you can add to the global variable `widgets`.](https://akkartik.itch.io/carousel/devlog/665231/a-sprite-editor-in-100-lines-of-code)
* A typographic scale for scaling the font size of text in visually pleasing
increments.
Tap the 'edit' button and then poke around the 'load' menu to learn more.
This repo is an example of a [Freewheeling App](http://akkartik.name/freewheeling),
designed above all to be easy to run, easy to modify and easy to share.
## Getting started
Install [LÖVE](https://love2d.org). It's just a 5MB download, open-source and
extremely well-behaved.
[Run the app using LÖVE.](https://love2d.org/wiki/Getting_Started#Running_Games)
## Hacking
You can edit the app and UI right on your device. However, there are some
gotchas to be aware of when editing such apps on a phone:
* If you upgrade LÖVE you lose all your local apps and their saved settings.
This includes code changes. It's hard to get code changes out due to mobile
restrictions. I can't come up with an alternative to copy-paste. This
imposes a strict limit on the number of changes I'm willing to make to a
large app on my phone.
* If you upgrade such apps after making local changes to them, you might see
strange errors. Local changes are written to an overlay directory, whereas
upgrades modify the app in place. The two locations create lots of
opportunity for conflicts to arise.
To mitigate this issue, such apps by default list local changes in the
output editor every time they run. That will hopefully act as a reminder.
There's also some helpers for deleting local changes in the 'scratch' page.
This repo is an example of a [Freewheeling App](http://akkartik.name/freewheeling),
designed above all to be easy to run, easy to modify and easy to share.