City Planner App Help Guide

The City Planner is a layout management tool that allows you to design, organize, and optimize your city. You can place and rearrange buildings, manage city properties, and experiment with layouts using snapshots and the inventory system.
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:

  • left_panel_close, left_panel_open, right_panel_close, right_panel_open — Show/hide left and right panels
  • dashboard — Navigate to City Planner Dashboard
  • save — Save city layout
  • zoom_out, zoom_in — Zoom out/in
  • fit_screen — Fit layout to screen
  • cached — Rotate selected building
  • delete — Delete selected building
  • select_all — Select all buildings of the same group (e.g., all small homes)
  • shelves — Toggle Inventory
  • stat_minus_1 — Move selected building to Inventory
  • stat_minus_2 — Move selected building group to Inventory
  • stat_minus_3 — Move all buildings to Inventory
  • delete_sweep — 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:

  • analytics Properties — Shows detailed stats for selected buildings and city-wide data.
  • view_list Snapshots — Manage saved layout states and compare city production between them. Snapshots help guide.
  • Calculators — Building cost calculator.
  • settings Settings — Layout visibility options, city rename, share, and delete actions.
Properties analytics

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 view_list

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 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: shelves
  • Add selected building: stat_minus_1
  • Add selected building group: stat_minus_2
  • Add all: stat_minus_3
  • Remove all (clear inventory): delete_sweep

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.