Merge template-carousel-mobile

README.md

@@ -25,11 +25,27 @@ extremely well-behaved.
 
 ## Hacking
 
-You can edit the game and UI right on your device.
+You can edit the game and UI right on your device. However, there are some
+gotchas to be aware of.
+
+* 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.
 
 You can also modify the editing environment itself, or repurpose it for a
 different app entirely, live as it runs. This requires running it on a
-computer. Download [the driver app](https://git.sr.ht/~akkartik/driver.love).
+computer, but is much more reliable. Download [the driver app](https://git.sr.ht/~akkartik/driver.love).
 Here's an example session showing the driver (left window) editing a different
 app (right window containing yellow text):
 
@@ -82,10 +98,8 @@ for creating the sprites and curating all the puzzles.
 
 This repo is a fork of [lines.love](http://akkartik.name/lines.html), an
 editor for plain text where you can also seamlessly insert line drawings.
-Its immediate upstream is [Lua Carousel, a lightweight cross-platform
-environment for creating little throwaway scripts on a computer or
-phone](https://git.sr.ht/~akkartik/carousel.love). Updates to it can be
-downloaded from the following mirrors:
+Its immediate upstream is [the template repo for mobile freewheeling apps](https://git.sr.ht/~akkartik/template-carousel-mobile).
+Updates to it can be downloaded from the following mirrors:
 
 * https://git.sr.ht/~akkartik/sokoban.love
 * https://tildegit.org/akkartik/sokoban.love

conf.lua

@@ -1,3 +1,4 @@
 function love.conf(t)
   t.identity = 'sokoban'
+  t.window.title = 'Sokoban'
 end

main.lua

@@ -55,7 +55,7 @@ function App.initialize(arg)
 
 
   -- keep a few blank lines around: https://merveilles.town/@akkartik/110084833821965708
-  love.window.setTitle('Sokoban')
+  -- setTitle moved to conf.lua