City Planner App Help Guide
Main Layout Area
The central working area represents your city bounds. You can open or close expansions by clicking on them. Buildings can be placed inside open expansions or outside the city limits.
Each building type has a distinct color. Buildings include two labels: name and level. Cultural buildings do not display names and are colored violet.
Buildings whose production is affected by happiness have a small happiness indicator disc. A fully violet disc means maximum happiness boost; a quarter-filled disc means 25% of the maximum bonus.
Top Toolbar
The top toolbar includes key tools:
- , , , — Show/hide left and right panels
- City Planner Dashboard — Navigate to
- — Save city layout
- , — Zoom out/in
- — Fit layout to screen
- — Rotate selected building
- — Delete selected building
- — Select all buildings of the same group (e.g., all small homes)
- — Toggle Inventory
- — Move selected building to Inventory
- — Move selected building group to Inventory
- — Move all buildings to Inventory
- — Remove all buildings from Inventory
Keyboard Shortcuts
City Planner supports a few useful keyboard shortcuts:
- Delete / Backspace — Delete the selected building
- R — Rotate the selected building
- D — Duplicate the selected building
Construction Menu (Left Panel)
The left panel lists all available buildings for your current city, organized by type. When Inventory is active, this panel displays stored buildings instead.
To place a building, click its item. It will be placed in the first fitting position (starting from the top-left), or outside the layout if no space is found.
Right Panel Overview
The right panel is a dynamic area that provides detailed information and tools depending on the menu you select. At the top of the panel, you'll find a vertical list of icon buttons — each one opens a different view inside the panel. Only one menu is active at a time.
The following menus are available:
- Properties — Shows detailed stats for selected buildings and city-wide data.
- Snapshots help guide. Snapshots — Manage saved layout states and compare city production between them.
- Calculators — Building cost calculator.
- Settings — Layout visibility options, city rename, share, and delete actions.
Properties
This view displays detailed information about the selected building, selected group of buildings, or the entire city. The content changes depending on what is selected.
- Selected Building:
- Building age
- Building name
- Level dropdown — allows changing the building's level
- Info section — shows general building information such as size
- Production section (if applicable):
- Displays happiness level indicator: how much happiness affects this building's production
- Worker count required
- Storage production — the maximum amount of product this building can store
- Production table — shows production values for 1h and 24h
- If the building allows selecting/toggling production, the product can be chosen or disabled by clicking on the selected item
- Customization section — visible if the building supports customizations; purely informative right now (no effect on calculations)
- Selected Group:
- Shared age is shown if all buildings have the same age
- Building name
- Level dropdown — empty if selected buildings have different levels; selecting a level here applies it to all
- City Properties:
- City name
- Allied City (if applicable):
- Displays the selected Wonder's name
- Includes a dropdown to change the Wonder's level
- Production section:
- Detailed table of all production
- Storage, 1h, and 24h columns
- Culture section:
- Total available happiness
- Total consumed happiness
- Utilization ratio — how efficiently happiness buildings are used
- Smaller unmet needs and higher ratios are better
- Area section:
- Total area used per building type
- Total area of open expansions
- Detailed breakdown by building group
- Workforce section:
- Available worker count
- Occupied worker count
All sections can be collapsed by clicking on their headers.
- City Age:
- The city's age is determined by the age of the City Hall building
- Some buildings behave differently depending on city age — for example, the Fountain of Youth
Snapshots
Allows you to save and compare different city layouts. Great for planning before committing to major changes. Learn more in the Snapshots Help.
Building Cost Calculator
The same calculator found in the Tools. When one building is selected, it shows its current level and next possible level. You can adjust both to calculate construction/upgrade costs.
Settings
- Toggle visibility of building names and levels
- Change city name
- Share or delete the city
Saving and Sharing
No auto-save! Be sure to save often to avoid losing progress. Saves are stored in your browser’s local storage, including layout, snapshots, and inventory.
To share a layout, open the Settings menu and click Share. In the dialog, press Create Link, then copy the link. On opening, the recipient will be asked for a city name before saving the layout to their device.
Inventory System
Inventory helps you temporarily remove buildings from the layout and reuse them easily:
- Toggle Inventory:
- Add selected building:
- Add selected building group:
- Add all:
- Remove all (clear inventory):
When active, the left panel shows stored buildings. Clicking a stored item places it at its original location if available; otherwise, the next fitting spot or outside layout.
Inventory data is saved with the city.