ui_state = {}  -- for buttons; recreated each frame
widgets = {}  -- more versatile UI elements
  ui_state.button_handlers = {}

  if mouse_press_consumed_by_any_button(ui_state, x,y, b) then
    skip_touch = true
    return
  end

function car.mouse_release(x,y, b)

  local stop_app_label = 'edit'
  button(ui_state, stop_app_label, {x=5, y=Safe_height-10-Line_height-10,
    w=5+App.width(stop_app_label)+5, h=5+Line_height+5,
    bg=Menu_background,
    icon = function(p)
      App.color(Normal_color)
      rect('line', p.x,p.y, p.w,p.h)
      g.print(stop_app_label, p.x+5, p.y+5)
    end,
    onpress1 = stop_app,
  })

  for _,touch_id in ipairs(touches()) do
    local x,y = touch(touch_id)
    circle('fill', x,y, 10)

  -- setTitle moved to conf.lua

  t.identity = 'TODO'
  t.window.title = 'TODO'

# A template repo for developing cross-platform apps on mobile devices

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.

In early release; please report issues, particularly with usability or
accessibility.

Tap the 'edit' button and then poke around the 'load' menu to learn more.

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:
In early release; please report issues, particularly with usability or
accessibility.
* 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 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.

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, 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):

Many thanks to [Michal Zalewski](https://lcamtuf.coredump.cx/sir-box-a-lot)

## Contributors

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:

* https://git.sr.ht/~akkartik/template-carousel-mobile
* https://tildegit.org/akkartik/template-carousel-mobile
* https://git.merveilles.town/akkartik/template-carousel-mobile
* https://nest.pijul.com/akkartik/template-carousel-mobile (using the Pijul version control system)