Seam Street · Customization Guide · version 1.0.0 · Main buyer guide

Customization Guide

Make Seam Street your own game: your own numbers, fashion pieces, sewing stations, collections, texts, music, logo and colors. Every part below is a short list of steps and says exactly which file to open. You do not need to know how to program: you change numbers, texts between quotes and picture files. All pictures on this page are real screenshots of the game in this package.

1. Before you start

Free tools you need:

Make a backup first. Copy the whole game/ folder (or source/) to a safe place before you change anything. If something breaks, put the backup back.

Which folder do I edit? The simplest way: edit the files inside game/ and upload that folder. If you also use the developer tools, edit source/ instead and run npm run build, which copies everything to source/dist/ (the same as game/). Both folders have the same file names, so every step below works in either one.

Starting a new game while you test: the game saves progress in the browser. Open the pause menu and choose Start over to see a change from the first minute. On your own computer (address localhost) you can also open a collection directly with ?debug&bairro=1 at the end of the address (0 is the first collection); this shortcut does nothing on a public website.

2. Where everything is

Each number on the screenshot matches a line of the table under it, with the exact file to change. Interface texts are in src/locales.js (English and Portuguese) and in src/locales/ (one file for each of the other 12 languages); the table gives the key of each text. <line> is one of the 7 fashion lines. Their internal names were kept from the engine and do not match what the player sees: grill = Hats, steam = Dresses, tea = Handbags, sweet = Shoes, sea = Summer Wear, noodle = Autumn Knits and warm = Winter Coats. A station uses the same 7 names. <id> is a collection: market = Boutique Avenue (its pictures are in assets/ui/), porto = Riviera Promenade, lotus = Maple Avenue and neve = Winter Gala. In the same way, flame.png is the spool of thread, lid.png the closed hatbox, dish.png the shopping bag of a delivery, btn-lantern.png the mannequin button, planter-on.png and planter-off.png the dressed and bare mannequins, lamp2-on.png the hangers of the panels and barraca-*.png the boutique front of wide screens; in src/config.js, STEPS and STEP_COST are the mannequins of a place and NIGHT_REWARD the prize of each year.

Title screen

Title screen, real screenshot with numbered parts 1 2 3
# What you see File to change
1 Logo assets/ui/logo.png, 900×388 pixels, transparent background (step G).
2 Play button Text: key ui.play (step E). Button picture: assets/ui/btn-gold-l.png, btn-gold-m.png and btn-gold-r.png (step H).
3 Title background assets/ui/splash-land.jpg on wide screens (1672×941) and assets/ui/splash.jpg on phones held upright (941×1672), step G.

The counter

The counter, real screenshot with numbered parts 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
# What you see File to change
1 Level Star: assets/ui/star.png. The bar fills with the stars of the mannequins: STEP_STARS and STARS_PER_LEVEL in src/config.js (step A).
2 Spools of thread (energy) Icon: assets/ui/flame.png (the spool keeps the internal name). Size of the basket and speed: ENERGY in src/config.js (step A).
3 Coins Icon: assets/ui/coin.png.
4 Customer assets/ui/who-1.png to who-6.png in the first collection; the same names inside assets/bairros/<id>/ in the others (step C).
5 Order and its pay What customers ask for and how much they pay: ORDERS in src/config.js (step A). Pictures on wide screens: assets/ui/barraca-balao.png and barraca-fita.png; on phones: assets/ui/tag.png.
6 Ready button assets/ui/btn-check.png. It appears when the pieces of the order are on the counter.
7 Boutique front around the customers Wide screens only (internal names kept): assets/ui/barraca-fundo.png, barraca-prateleira.png, barraca-placa.png, barraca-placa-p.png and barraca-corda.png.
8 Counter squares assets/ui/tile-l.png (wide screens) and assets/ui/tile-p.png (phones); frame: assets/ui/frame.png. The tint of each collection is in style-more.css (step H).
9 Sewing station assets/items/gen-<line>-1.png to -5.png, one picture per station level (step B). Name: key gen.<line>.
10 Fashion piece assets/items/<line>-1.png to -8.png (step B). Names: the list item.<line>.
11 Hatbox with a number assets/ui/lid.png (the closed hatbox keeps the internal name). The level that opens each square is the list UNLOCK in src/config.js.
12 Name of the selected piece Texts: item.<line>, ui.lv, ui.next (step E). Panel picture: assets/ui/panel-plain.png.
13 Sell button assets/ui/btn-orange.png (it turns into Deliver with btn-green.png). Text: ui.sell. Price: SELL in src/config.js.
14 Lookbook button assets/ui/icon-9.png. Reward of a complete page: BOOK_REWARD in src/config.js.
15 Shelf assets/ui/shelf-land.png (wide screens), shelf-port.png and slot-port.png (phones).
16 Gift box assets/ui/btn-gift.png; the red dot is dot.png.
17 Street button (mannequin) assets/ui/btn-lantern.png (internal name kept).
18 Pause button assets/ui/btn-pause.png.
19 Scenery behind the counter scene-land.jpg (wide screens, 1672×941) and scene.jpg (phones, 1914×822), in assets/ui/ for the first collection and in assets/bairros/<id>/ for the others (step C).

The street

The street, real screenshot with numbered parts 1 2 3 4 5 6 7 8 9
# What you see File to change
1 Collection name Text: key bairro.<id> (steps D and E).
2 Map of the collections Drawn by the code from the list DISTRICTS: one medallion per collection, assets/ui/season-1.png to season-4.png; padlock: assets/ui/lock.png.
3 Picture of the place area-1.png, area-2.png, area-3.png (533×534) of the collection (step C).
4 Name of the place Text: key area.<place>; the three places of a collection are listed in DISTRICTS.
5 Mannequins assets/ui/planter-on.png (dressed) and planter-off.png (bare), internal names kept. There are 6 per place (STEPS).
6 Price of the next mannequin STEP_COST and DISTRICT_COST in src/config.js (step A).
7 Locked place assets/ui/plate-lock.png and lock.png. In the first collection the places open at the levels of AREAS; in the others, one after the other.
8 Back to the atelier Text: key ui.kitchen.
9 Street background street-dark.jpg (empty shop windows) and street.jpg (dressed), both 941×1672, on phones; on wide screens scene-land-dark.jpg and scene-land.jpg (1672×941), step C.

A card (new level)

A card (new level), real screenshot with numbered parts 1 2 3 4 5 6
# What you see File to change
1 Medal assets/ui/medal.png.
2 Title of the card Texts: ui.levelUp and ui.levelUpSub. Plate picture: assets/ui/plate.png.
3 Hanger with a dress assets/ui/lamp2-on.png (internal name kept).
4 Prizes of the level assets/ui/prize-flame.png (spools), steamer-open.png (open hatbox: more counter) and prize-gift.png.
5 Button of the card Text: key ui.ok. Picture: the three btn-gold-*.png files.
6 Card assets/ui/panel-plain.png, the border greca.png, the fireworks fogos-1.png and fogos-2.png.
Rush hour and special customer, real screenshot
Rush hour (the banner at the top) and a special customer with the ×3 seal, in Winter Gala. Numbers: step A.
Better station card, real screenshot
Two equal stations merged: the card shows what the station can sew now (GEN_DROPS in src/config.js).
New collection card, real screenshot
A new collection: its first place (area-1.png) and its new station.
The counter in Riviera Promenade, real screenshot
Riviera Promenade: its own scenery, customers and counter color (steps C and H).
Lookbook, real screenshot
Lookbook: one tab per fashion line, 8 pieces and the 5 levels of the station.
Win card, real screenshot
The 4 collections dressed: the prize of the year (NIGHT_REWARD) and the next year.
The counter on a phone, real screenshot
The counter on a phone held upright: customers at the top, shelf at the bottom.
The street on a phone, real screenshot
The street on a phone (street.jpg upright).
Pause menu on a phone, real screenshot
Pause menu: volumes, language, less motion, Resume, Menu, Start over.

4. Step A: change the numbers of the game

Every number is in one file, src/config.js. Open it in the code editor, change only the number, keep the commas and save. Each line has a short comment (in Portuguese) next to it.

What Name in src/config.js As shipped
Size of the basket of spools ENERGY.max 100
Time to get 1 spool back ENERGY.regenMs (thousandths of a second) 2000 = 2 seconds
Spools given back by a delivery ENERGY.refund (part of the cost of the order) 0.5
Price of the mannequins STEP_COST: the first number is the price of the first mannequin, the second makes each next one dearer 40 and 10 (40, 50, 75, 112 … coins)
How much dearer each collection is DISTRICT_COST 0.35 (35% more per collection)
Stars per mannequin, stars per level STEP_STARS, STARS_PER_LEVEL 2 and 3
Customers at the same time ORDERS.slots (at levels 1, 2 and 3 or more) 1, 2, 3
Pieces in one order ORDERS.maxItems (at levels 1, 2, 3 and 4 or more) 1, 2, 2, 3
Pay of an order ORDERS.pay 2
Free change of an order ORDERS.swapMs 120000 = 2 minutes
Special customer ORDERS.vipChance (0 to 1), ORDERS.vipPay, ORDERS.vipFrom (level) 0.12, 3, 3
Rush hour ORDERS.rushEvery (deliveries), ORDERS.rushMs, ORDERS.rushPay, ORDERS.rushFrom (level) 12, 60000 = 60 seconds, 2, 3
Prize of the year NIGHT_REWARD (multiplied by the number of the year) 500
Prize of a page of the Lookbook BOOK_REWARD 80
Level at which the Dress and Shoe stations arrive at in GENS 4 and 7

5. Step B: change the picture of a piece or a station

  1. Pieces and stations are in assets/items/. A piece is <line>-1.png to <line>-8.png (for example tea-1.png … tea-8.png are the 8 handbags). A station is gen-<line>-1.png to gen-<line>-5.png.
  2. Draw your picture as a square PNG of 256×256 pixels with a transparent background, with the object filling most of the square. A bigger square also works (we tried 512×512: the game draws it in the same space), it only makes the download heavier.
  3. Save it with exactly the same name as the picture you replace and copy it over the old file.
  4. Change the name of the piece in the list item.<line> (8 names, in order) and the name of the station in gen.<line>, in every language you use (step E). The name of the fashion line on the Lookbook is chain.<line>.

6. Step C: change the scenery and the customers of a collection

The first collection (Boutique Avenue) keeps its pictures in assets/ui/. The others have one folder each: assets/bairros/porto/ (Riviera Promenade), assets/bairros/lotus/ (Maple Avenue) and assets/bairros/neve/ (Winter Gala). Every collection uses the same 14 file names:

File Size as shipped Where it appears
scene.jpg 1914×822 Scenery above the counter on phones held upright
scene-land.jpg 1672×941 Scenery behind the counter on wide screens, and the street on wide screens once its mannequins are dressed
scene-land-dark.jpg 1672×941 The same wide scenery with the shop windows still empty (the street on wide screens)
street.jpg 941×1672 The street on phones with the shop windows dressed; also the picture of the collection on the win card
street-dark.jpg 941×1672 The same street with the shop windows empty (the dressed one fades in over it)
area-1.png, area-2.png, area-3.png 533×534 The three places of the street; area-1.png is also the picture of the collection on its new-collection card
who-1.png … who-6.png about 300×285, transparent background The six customers, from the waist up
  1. Prepare your pictures in the same sizes and proportions.
  2. Give them the same names and copy them over the old files of that collection.
  3. street.jpg and street-dark.jpg must be the same drawing, one with the shop windows dressed and one with them empty; the same for scene-land.jpg and scene-land-dark.jpg.
  4. The names of the collection and of its places are texts: bairro.<id> and area.<place> (step E).

7. Step D: add a collection

We tried these steps with a fifth collection called silk: the street, the map of the collections and the win card showed the 5 collections on a phone and on a wide screen.

  1. Choose a short name with no spaces or accents, for example silk, and three names for its places, for example lobby, salon and runway.
  2. Open src/config.js, find DISTRICTS and add a line at the end of the list, before the ];:
    export const DISTRICTS = [
      { id: 'market', areas: ['gate', 'alley', 'plaza'] },
      { id: 'porto', areas: ['harbor', 'pier', 'lighthouse'] },
      { id: 'lotus', areas: ['roundgate', 'bridge', 'pavilion'] },
      { id: 'neve', areas: ['icegate', 'hotrow', 'icegarden'] },
      { id: 'silk', areas: ['lobby', 'salon', 'runway'] },
    ];
  3. Create the folder assets/bairros/silk/ with the 14 pictures of step C. To start, copy the folder of another collection and replace the pictures one by one.
  4. Add the music assets/music/silk.mp3 (step F). Without this file the collection is silent.
  5. Add its medallion for the map of the collections: assets/ui/season-5.png (the four shipped ones are season-1.png to season-4.png; copy season-4.png to start). Without it the map shows an empty circle.
  6. Open src/locales.js and add the four texts to the English block, next to the other bairro. lines, and to the Portuguese block (the test of the source checks that Portuguese has every English text; the other languages show the English text until you translate it):
        'bairro.silk': 'Silk Week',
        'area.lobby': 'Silk Lobby',
        'area.salon': 'Silk Salon',
        'area.runway': 'Silk Runway',
  7. Optional, the color of the counter: in style-more.css, copy the block body[data-bairro="porto"] (the last one in the file with that name), change porto to silk and choose the two colors. Without it the collection uses the color of the first one.
  8. Save, start the game and, on your computer, open ?debug&bairro=4 to see the new collection (the count starts at 0).
Good to know. The year now ends after 5 collections, so the prize of the year and "Year 2" come after the new one. A new collection does not bring a new station by itself: the three stations of the collections are set in GENS (dist: 1, 2, 3) and a new fashion line needs a programmer (see What needs a programmer). Do not remove a collection or change the order in a game that is already online: players' saves keep the number of the collection.

8. Step E: change texts and languages

  1. English and Portuguese are in src/locales.js (the blocks en: and pt:, and a few more lines added below them). Each of the other 12 languages has its own file in src/locales/: es.js, fr.js, de.js, it.js, nl.js, pl.js, tr.js, ru.js, id.js, ja.js, ko.js, zh.js.
  2. Each line is 'key': 'text',. Change only the text between the quotes. Keep the key, the quotes and the comma. Keep words in braces such as {n} and {x}: the game puts a number or a name there. If your text has an apostrophe, write the text between double quotes, as in "Let's go!".
  3. Useful keys: ui.play (title button), tut.0 to tut.8 (the tutorial), tip.gift, tip.shelf, tip.swap, tip.book, tip.vip (tips), bairro.* and area.* (collections and places), item.* (lists of 8 piece names), gen.* (stations), chain.* (fashion lines), ui.book (the Lookbook), ui.rush, ui.vip, ui.win and ui.winSub (win card).
  4. A key missing in a language shows the English text.
  5. To add a language (tried with a 15th language): copy a file of src/locales/, for example es.js to ca.js, and translate it. In src/locales-more.js add the line import ca from './locales/ca.js'; and add ca to the list in the last line (export const MORE = { … zh, ca };). In src/locales.js add ['ca', 'Català'], to LANGS. The language then appears in the pause menu and ?lang=ca works.
  6. If you use source/, run npm test: it checks keys and braces in every language. After adding a language, change the number in the line assert.equal(LANGS.length, 14); of test/locales.test.mjs to the new count, or that test fails.

The bundled font has Latin letters only: Russian, Japanese, Korean and Chinese texts are drawn with a font of the player's device (step H).

9. Step F: replace or remove the music

  1. Logo: replace assets/ui/logo.png (900×388 pixels, transparent background). It is shown on the title screen.
  2. Title background: assets/ui/splash.jpg (phones held upright, 941×1672) and assets/ui/splash-land.jpg (wide screens, 1672×941). Leave room for the logo at the top and for the Play button.
  3. Name in the browser tab: open index.html and change the text inside <title>. The same file has the logo description in alt="Seam Street".
  4. Name of the installed web app: name and short_name in manifest.webmanifest.
  5. Icons: favicon.ico (browser tab), assets/icon-180.png (180×180), assets/icon-192.png (192×192) and assets/icon-512.png (512×512), square, without transparency. Replace them keeping the names.
  6. The stylist of the tutorial is assets/ui/guide.png (268×300, transparent) and the pointing hand is assets/ui/hand.png.

11. Step H: change colors and the font

12. What needs a programmer

These parts are built into the code and the layout. Changing only a number or a file is not enough:

For custom work, write to willian@polargames.com.br.

13. Check and publish your changes

  1. Play the parts you changed on your computer (see Before you start), in a wide window and in a narrow one (F12, then Ctrl+Shift+M shows phone sizes).
  2. If you edited source/: in a terminal inside source/, run the commands below. The first checks the rules, the pace and the texts; the second copies the game to source/dist/.
npm test
npm run build
  1. Upload everything inside game/ (or source/dist/, if you built it) to your web hosting, replacing the old files.
  2. Open your game address and press Ctrl+F5. If you still see the old version, read the section about updates and cache in the main buyer guide.

14. If something goes wrong