Closet

A web app for iPhone: photograph your clothes, the app removes the background and sorts each item into a category, and then you put outfits together by swiping. Finished outfits can be saved.

App address: https://lucia-ship-it.github.io/closet/

What the app does

• Add: photograph an item, the background is removed automatically, touch it up (eraser, straighten, Enhance) and choose a category (Top, Bottom, Dress, Sweater, Jacket, Shoes).
• Outfit: swipe through your items, optionally add a sweater or jacket over a top or dress, and shoes. The Complete button shows the outfit put together, where every piece can be moved and resized. The heart saves the outfit.
• Saved: your saved outfits.
• Closet: all your items, filters by category, changing an item's category, touching up its photo and deleting it.

Files

File	What it does
index.html	Structure of the screens
style.css	Look and feel. The colours are right at the top of the file
app.js	App behaviour: swiping, putting outfits together, saved outfits, Closet, adding items, update check
editor.js	Photo touch-up: eraser, restore, zoom, Enhance
image.js	Background removal, straightening and cropping of photos
enhance.js	Simple photo enhancement (light, contrast, colours)
db.js	Saving items and outfits on the phone
serve.py	A small server for trying the app on a Mac
manifest.webmanifest, icon.png	So the app can be added to the Home Screen like an app
LICENSE	Licence (all rights reserved)
CLAUDE.md	Description of the app, decisions and requirements, for further work

Running it on a Mac

In the terminal in VS Code (menu Terminal → New Terminal):

python3 serve.py

Then open http://localhost:8000 in a browser.

How a change reaches the phone

1. Changes are saved (committed) and pushed to GitHub in VS Code with Source Control → Sync Changes.
2. GitHub Pages publishes them a minute or two later.
3. The app on the Home Screen finds the new version by itself when it starts (or shows an Update bar at the top). You can also check by hand with the Check for updates button at the bottom of the Add screen.

Adding the app to the iPhone Home Screen

1. Open the address in Safari.
2. Tap Share, then Add to Home Screen.
3. Always open the app from the Home Screen icon.

Good to know

• Items and outfits are stored only on this device. Only the code is on GitHub. Do not delete the Home Screen icon or the website data in Safari, you would lose your closet. There is no backup yet.
• The data belongs to the main part of the address (lucia-ship-it.github.io). Renaming the repository keeps it, but the old address stops working and the Home Screen icon has to be added again. Changing the account name or using a custom domain would leave the closet empty.
• The first time the background is removed, an AI model is downloaded (tens of MB). It is better to be on Wi-Fi.
• Background removal uses a library from IMG.LY (AGPL-3.0 licence).