iphone-dimensions 1.0.0 → 1.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +59 -29
  2. package/package.json +7 -4
package/README.md CHANGED
@@ -1,22 +1,56 @@
1
1
  # iphone-dimensions
2
2
 
3
- Apple's published dimensions for every iPhone since the iPhone 7, as JSON, CSV and an npm package. Height, width, depth, weight, display size, resolution and pixel density, with the Apple page each row was checked against.
4
-
5
- This is the data behind [iphonesize.com](https://iphonesize.com), which draws any of these phones next to each other at true scale in 3D. The full table is also a plain web page at [iphonesize.com/data](https://iphonesize.com/data).
6
-
7
- | Phone | Height | Width | Depth | Weight | Display |
8
- | --- | --- | --- | --- | --- | --- |
9
- | iPhone Duo (closed) | 117.8 mm | 84.1 mm | 11.3 mm | 254 g | 5.4 in |
10
- | iPhone Duo (open) | 117.8 mm | 164.6 mm | 5.2 mm | 254 g | 7.6 in |
11
- | iPhone 18 Pro Max | 163.4 mm | 78 mm | 8.75 mm | 249 g | 6.9 in |
12
- | iPhone 18 Pro | 150 mm | 71.9 mm | 8.75 mm | 211 g | 6.3 in |
13
- | iPhone Air | 156.2 mm | 74.7 mm | 5.64 mm | 165 g | 6.5 in |
14
- | iPhone 16 | 147.6 mm | 71.6 mm | 7.8 mm | 170 g | 6.1 in |
15
- | iPhone 13 mini | 131.5 mm | 64.2 mm | 7.65 mm | 141 g | 5.4 in |
16
- | iPhone SE (3rd generation) | 138.4 mm | 67.3 mm | 7.3 mm | 144 g | 4.7 in |
17
- | iPhone 7 | 138.3 mm | 67.1 mm | 7.1 mm | 138 g | 4.7 in |
18
-
19
- The folding iPhone Duo has two rows, one closed and one open. They share a `product_id`.
3
+ Apple's published dimensions for every iPhone since the iPhone 7: height, width, depth, weight, display, resolution and ppi, with the Apple page linked on every row. JSON, CSV and an npm package.
4
+
5
+ It is the data behind [iphonesize.com](https://iphonesize.com), which draws any two phones next to each other at true scale. The table is also a web page at [iphonesize.com/data](https://iphonesize.com/data).
6
+
7
+ | Phone | Released | Height | Width | Depth | Weight | Display | ppi | Apple source |
8
+ | --- | --- | --- | --- | --- | --- | --- | --- | --- |
9
+ | iPhone Duo (closed) | 2026 | 117.8 mm | 84.1 mm | 11.3 mm | 254 g | 5.4 in | 460 | [specs](https://www.apple.com/iphone-duo/specs/) |
10
+ | iPhone Duo (open) | 2026 | 117.8 mm | 164.6 mm | 5.2 mm | 254 g | 7.6 in | 430 | [specs](https://www.apple.com/iphone-duo/specs/) |
11
+ | iPhone 18 Pro Max | 2026 | 163.4 mm | 78 mm | 8.75 mm | 249 g | 6.9 in | 460 | [specs](https://www.apple.com/iphone-18-pro/specs/) |
12
+ | iPhone 18 Pro | 2026 | 150 mm | 71.9 mm | 8.75 mm | 211 g | 6.3 in | 460 | [specs](https://www.apple.com/iphone-18-pro/specs/) |
13
+ | iPhone 17 Pro Max | 2025 | 163.4 mm | 78 mm | 8.75 mm | 233 g | 6.9 in | 460 | [specs](https://support.apple.com/en-us/125091) |
14
+ | iPhone 17 Pro | 2025 | 150 mm | 71.9 mm | 8.75 mm | 206 g | 6.3 in | 460 | [specs](https://support.apple.com/en-us/125090) |
15
+ | iPhone Air | 2025 | 156.2 mm | 74.7 mm | 5.64 mm | 165 g | 6.5 in | 460 | [specs](https://support.apple.com/en-us/125092) |
16
+ | iPhone 17 | 2025 | 149.6 mm | 71.5 mm | 7.95 mm | 177 g | 6.3 in | 460 | [specs](https://support.apple.com/en-us/125089) |
17
+ | iPhone 17e | 2026 | 146.7 mm | 71.5 mm | 7.8 mm | 169 g | 6.1 in | 460 | [specs](https://support.apple.com/en-us/126470) |
18
+ | iPhone 16 Pro Max | 2024 | 163 mm | 77.6 mm | 8.25 mm | 227 g | 6.9 in | 460 | [specs](https://support.apple.com/en-us/121032) |
19
+ | iPhone 16 Pro | 2024 | 149.6 mm | 71.5 mm | 8.25 mm | 199 g | 6.3 in | 460 | [specs](https://support.apple.com/en-us/121031) |
20
+ | iPhone 16 Plus | 2024 | 160.9 mm | 77.8 mm | 7.8 mm | 199 g | 6.7 in | 460 | [specs](https://support.apple.com/en-us/121030) |
21
+ | iPhone 16 | 2024 | 147.6 mm | 71.6 mm | 7.8 mm | 170 g | 6.1 in | 460 | [specs](https://support.apple.com/en-us/121029) |
22
+ | iPhone 16e | 2025 | 146.7 mm | 71.5 mm | 7.8 mm | 167 g | 6.1 in | 460 | [specs](https://support.apple.com/en-us/122208) |
23
+ | iPhone 15 Pro Max | 2023 | 159.9 mm | 76.7 mm | 8.25 mm | 221 g | 6.7 in | 460 | [specs](https://support.apple.com/en-us/111828) |
24
+ | iPhone 15 Pro | 2023 | 146.6 mm | 70.6 mm | 8.25 mm | 187 g | 6.1 in | 460 | [specs](https://support.apple.com/en-us/111829) |
25
+ | iPhone 15 Plus | 2023 | 160.9 mm | 77.8 mm | 7.8 mm | 201 g | 6.7 in | 460 | [specs](https://support.apple.com/en-us/111830) |
26
+ | iPhone 15 | 2023 | 147.6 mm | 71.6 mm | 7.8 mm | 171 g | 6.1 in | 460 | [specs](https://support.apple.com/en-us/111831) |
27
+ | iPhone 14 Pro Max | 2022 | 160.7 mm | 77.6 mm | 7.85 mm | 240 g | 6.7 in | 460 | [specs](https://support.apple.com/en-us/111846) |
28
+ | iPhone 14 Pro | 2022 | 147.5 mm | 71.5 mm | 7.85 mm | 206 g | 6.1 in | 460 | [specs](https://support.apple.com/en-us/111849) |
29
+ | iPhone 14 Plus | 2022 | 160.8 mm | 78.1 mm | 7.8 mm | 203 g | 6.7 in | 458 | [specs](https://support.apple.com/en-us/111854) |
30
+ | iPhone 14 | 2022 | 146.7 mm | 71.5 mm | 7.8 mm | 172 g | 6.1 in | 460 | [specs](https://support.apple.com/en-us/111850) |
31
+ | iPhone 13 Pro Max | 2021 | 160.8 mm | 78.1 mm | 7.65 mm | 240 g | 6.7 in | 458 | [specs](https://support.apple.com/en-us/111870) |
32
+ | iPhone 13 Pro | 2021 | 146.7 mm | 71.5 mm | 7.65 mm | 204 g | 6.1 in | 460 | [specs](https://support.apple.com/en-us/111871) |
33
+ | iPhone 13 mini | 2021 | 131.5 mm | 64.2 mm | 7.65 mm | 141 g | 5.4 in | 476 | [specs](https://support.apple.com/en-us/111873) |
34
+ | iPhone 13 | 2021 | 146.7 mm | 71.5 mm | 7.65 mm | 174 g | 6.1 in | 460 | [specs](https://support.apple.com/en-us/111872) |
35
+ | iPhone SE (3rd generation) | 2022 | 138.4 mm | 67.3 mm | 7.3 mm | 144 g | 4.7 in | 326 | [specs](https://support.apple.com/en-us/111866) |
36
+ | iPhone 12 Pro Max | 2020 | 160.8 mm | 78.1 mm | 7.4 mm | 228 g | 6.7 in | 458 | [specs](https://support.apple.com/en-us/111874) |
37
+ | iPhone 12 Pro | 2020 | 146.7 mm | 71.5 mm | 7.4 mm | 189 g | 6.1 in | 460 | [specs](https://support.apple.com/en-us/111875) |
38
+ | iPhone 12 mini | 2020 | 131.5 mm | 64.2 mm | 7.4 mm | 135 g | 5.4 in | 476 | [specs](https://support.apple.com/en-us/111877) |
39
+ | iPhone 12 | 2020 | 146.7 mm | 71.5 mm | 7.4 mm | 164 g | 6.1 in | 460 | [specs](https://support.apple.com/en-us/111876) |
40
+ | iPhone 11 Pro Max | 2019 | 158 mm | 77.8 mm | 8.1 mm | 226 g | 6.5 in | 458 | [specs](https://support.apple.com/en-us/111878) |
41
+ | iPhone 11 Pro | 2019 | 144 mm | 71.4 mm | 8.1 mm | 188 g | 5.8 in | 458 | [specs](https://support.apple.com/en-us/111879) |
42
+ | iPhone 11 | 2019 | 150.9 mm | 75.7 mm | 8.3 mm | 194 g | 6.1 in | 326 | [specs](https://support.apple.com/en-us/111865) |
43
+ | iPhone SE (2nd generation) | 2020 | 138.4 mm | 67.3 mm | 7.3 mm | 148 g | 4.7 in | 326 | [specs](https://support.apple.com/en-us/111882) |
44
+ | iPhone XS Max | 2018 | 157.5 mm | 77.4 mm | 7.7 mm | 208 g | 6.5 in | 458 | [specs](https://support.apple.com/en-us/111880) |
45
+ | iPhone XS | 2018 | 143.6 mm | 70.9 mm | 7.7 mm | 177 g | 5.8 in | 458 | [specs](https://support.apple.com/en-us/111881) |
46
+ | iPhone XR | 2018 | 150.9 mm | 75.7 mm | 8.3 mm | 194 g | 6.1 in | 326 | [specs](https://support.apple.com/en-us/111868) |
47
+ | iPhone X | 2017 | 143.6 mm | 70.9 mm | 7.7 mm | 174 g | 5.8 in | 458 | [specs](https://support.apple.com/en-us/111864) |
48
+ | iPhone 8 Plus | 2017 | 158.4 mm | 78.1 mm | 7.5 mm | 202 g | 5.5 in | 401 | [specs](https://support.apple.com/en-us/111950) |
49
+ | iPhone 8 | 2017 | 138.4 mm | 67.3 mm | 7.3 mm | 148 g | 4.7 in | 326 | [specs](https://support.apple.com/en-us/111976) |
50
+ | iPhone 7 Plus | 2016 | 158.2 mm | 77.9 mm | 7.3 mm | 188 g | 5.5 in | 401 | [specs](https://support.apple.com/en-us/111953) |
51
+ | iPhone 7 | 2016 | 138.3 mm | 67.1 mm | 7.1 mm | 138 g | 4.7 in | 326 | [specs](https://support.apple.com/en-us/111943) |
52
+
53
+ The folding iPhone Duo has two rows, closed and open, sharing one `product_id`.
20
54
 
21
55
  ## Get the data
22
56
 
@@ -43,7 +77,7 @@ findPhones('17 air'); // finds "iPhone Air", which many people call the 17
43
77
  getProduct('iphone-duo'); // both Duo rows, closed first
44
78
  ```
45
79
 
46
- Works with `import` and `require`, in Node 18 or later, and in bundlers and browsers. No dependencies. The raw files are exported too: `iphone-dimensions/data/iphones.json` and `iphone-dimensions/data/iphones.csv`.
80
+ Works with `import` and `require`, in Node 18 or later, bundlers and browsers. No dependencies. The raw files are exported as `iphone-dimensions/data/iphones.json` and `.csv`.
47
81
 
48
82
  ## Fields
49
83
 
@@ -64,26 +98,22 @@ Works with `import` and `require`, in Node 18 or later, and in bundlers and brow
64
98
  | `source_url` | The Apple tech-specs page the measurements were checked against |
65
99
  | `dates_source_url` | The Apple Newsroom page the dates were checked against |
66
100
 
67
- Rows follow the site's lineup order. The top-level `verified` field is the date the measurements were last checked, and `notes` repeats the caveats below in machine-readable form.
101
+ Top-level `verified` is the date the measurements were last checked; `notes` carries the caveats below in machine-readable form.
68
102
 
69
103
  ## Where the numbers come from
70
104
 
71
- The metric measurements, display size, resolution and pixel density are the values Apple publishes on its tech-specs pages at apple.com and support.apple.com. The dates come from Apple Newsroom. Each row links to both.
72
-
73
- Three things are ours, not Apple's. The `id` slugs are ours. The inch and ounce values are calculated from Apple's metric figures, so they can differ from Apple's own rounded imperial numbers by 0.01. And `ppi` is Apple's stated figure, which can differ by a few pixels per inch from what you get by dividing the resolution by the marketed diagonal, because the marketed diagonal is rounded.
74
-
75
- Depth is the body only. Apple's consumer tech-specs pages do not list how far the camera protrudes, and this dataset leaves out anything measured or estimated.
105
+ Measurements, display size, resolution and pixel density are Apple's, from the tech-specs page linked on each row. Dates are from Apple Newsroom, linked in the JSON. Nothing is measured or estimated by us.
76
106
 
77
- **Do not use this to make cases or accessories.** It has no tolerances, button positions, port locations or camera keep-outs. Apple publishes [dimensional drawings](https://developer.apple.com/accessories/dimensional-drawings/) for that.
107
+ The inch and ounce columns are converted from Apple's metric figures and can differ from Apple's own rounded numbers by 0.01. `ppi` is Apple's stated figure. Depth is the body without the camera bump.
78
108
 
79
- ## Corrections and updates
109
+ **Not for making cases or accessories.** There are no tolerances, button positions or camera keep-outs here. Apple publishes [dimensional drawings](https://developer.apple.com/accessories/dimensional-drawings/) for that.
80
110
 
81
- The files in `data/` and `dist/` are generated. `data/` is copied from the iphonesize.com build with `npm run sync`, which validates both files before replacing them as a pair, and `dist/` is built from `data/`. Please do not edit either by hand in a pull request. If a number is wrong, open an issue with a link to the Apple page and it gets fixed at the source.
111
+ ## Updates
82
112
 
83
- Versions follow semver: a patch is a corrected fact or a docs change, a minor adds phones or optional fields, and a major removes or renames a field or changes what one means. New iPhones are added once Apple's spec page is up and checked.
113
+ `data/` is pulled from the iphonesize.com build by `npm run sync` and `dist/` is built from it, so please do not edit either by hand. Wrong number? Open an issue with the Apple page and it gets fixed at the source. Patch releases fix facts, minor releases add phones or fields, major releases change or remove a field.
84
114
 
85
115
  ## Licence
86
116
 
87
- The code is MIT licensed. The data is a table of facts Apple publishes, and you are free to use it for anything. This licence cannot grant rights that belong to Apple, and nothing here is Apple's text or imagery. If you publish something built on it, a link back to [iphonesize.com](https://iphonesize.com) is appreciated.
117
+ MIT for the code. The data is facts Apple publishes; use it however you like. This licence cannot grant rights that belong to Apple. A link back to [iphonesize.com](https://iphonesize.com) is appreciated.
88
118
 
89
119
  Not affiliated with Apple. iPhone is a trademark of Apple Inc.
package/package.json CHANGED
@@ -1,14 +1,17 @@
1
1
  {
2
2
  "name": "iphone-dimensions",
3
- "version": "1.0.0",
3
+ "version": "1.0.3",
4
4
  "description": "Apple's published dimensions for every iPhone since the iPhone 7: height, width, depth, weight, display and pixel density, in mm and inches, each row cited to Apple's tech specs.",
5
5
  "license": "MIT",
6
6
  "type": "module",
7
7
  "sideEffects": false,
8
- "homepage": "https://iphonesize.com/data-sources",
9
- "repository": "github:iphonesize/iphone-dimensions",
8
+ "homepage": "https://iphonesize.com/data",
9
+ "repository": {
10
+ "type": "git",
11
+ "url": "git+https://github.com/iPhoneSize/iphone-dimensions.git"
12
+ },
10
13
  "bugs": {
11
- "url": "https://github.com/iphonesize/iphone-dimensions/issues"
14
+ "url": "https://github.com/iPhoneSize/iphone-dimensions/issues"
12
15
  },
13
16
  "keywords": [
14
17
  "iphone",