11#!/usr/bin/env node
22
3- // Renders the Android adaptive-icon layers from the Icon Composer SVG sources.
3+ // Renders the Android launcher and splash artwork from the Icon Composer SVG sources.
44//
55// Icon Composer exports already contain a rounded-square silhouette, and Android masks
66// the central 72dp of a 108dp adaptive canvas, so exporting them as a foreground produces
77// a double-framed icon with the letters cropped by the mask. Instead, each variant gets a
88// full-bleed background layer (the artwork behind the wordmark) and a shared transparent
99// foreground that keeps the wordmark inside the safe zone.
10+ //
11+ // The Android 12+ splash screen masks its icon to a circle covering the central two thirds
12+ // of a 288dp canvas, which is the same proportion the launcher crops. Composing the two
13+ // adaptive layers into one 288dp image therefore makes the splash frame the wordmark
14+ // exactly like the launcher icon does.
1015
1116import * as NodeRuntime from "@effect/platform-node/NodeRuntime" ;
1217import * as NodeServices from "@effect/platform-node/NodeServices" ;
@@ -19,8 +24,10 @@ import sharp from "sharp";
1924
2025type IconVariant = "dev" | "nightly" | "prod" ;
2126
22- // 108dp at xxxhdpi. Expo's prebuild derives every density bucket from this.
23- const CANVAS = 432 ;
27+ // 108dp at xxxhdpi. Expo's prebuild derives every launcher density bucket from this.
28+ const ADAPTIVE_CANVAS = 432 ;
29+ // 288dp at xxxhdpi: the full Android 12+ splash canvas, so the icon needs no upscaling.
30+ const SPLASH_CANVAS = 1152 ;
2431// Icon Composer's layer sources use a 128pt viewBox; the wordmark path spans this box.
2532const TEXT = { x : 15.53 , y : 37 , width : 94.5 , height : 57 } ;
2633// Wordmark width as a fraction of the 108dp canvas. The visible area is 72dp (66dp
@@ -31,21 +38,23 @@ const WORDMARK_FRACTION = 0.48;
3138const COMPOSER_CANVAS_PT = 1024 ;
3239const SVG_DENSITY = 300 ;
3340const OUTPUT_DIRECTORY = "apps/mobile/assets" ;
41+ // Production has no background artwork, so its splash composes onto the adaptive color.
42+ const PRODUCTION_BACKGROUND_COLOR = "#000000" ;
3443
3544export class AndroidIconRenderError extends Schema . TaggedErrorClass < AndroidIconRenderError > ( ) (
3645 "AndroidIconRenderError" ,
3746 { layer : Schema . String , cause : Schema . Defect ( ) } ,
3847) { }
3948
40- const wordmarkTransform = ( ) => {
41- const scale = ( CANVAS * WORDMARK_FRACTION ) / TEXT . width ;
42- const tx = ( CANVAS - TEXT . width * scale ) / 2 - TEXT . x * scale ;
43- const ty = ( CANVAS - TEXT . height * scale ) / 2 - TEXT . y * scale ;
49+ const wordmarkTransform = ( size : number ) => {
50+ const scale = ( size * WORDMARK_FRACTION ) / TEXT . width ;
51+ const tx = ( size - TEXT . width * scale ) / 2 - TEXT . x * scale ;
52+ const ty = ( size - TEXT . height * scale ) / 2 - TEXT . y * scale ;
4453 return `translate(${ tx . toFixed ( 3 ) } ${ ty . toFixed ( 3 ) } ) scale(${ scale . toFixed ( 4 ) } )` ;
4554} ;
4655
47- const canvasSvg = ( inner : string ) =>
48- `<svg xmlns="http://www.w3.org/2000/svg" width="${ CANVAS } " height="${ CANVAS } " viewBox="0 0 ${ CANVAS } ${ CANVAS } " fill="none">${ inner } </svg>` ;
56+ const canvasSvg = ( size : number , inner : string ) =>
57+ `<svg xmlns="http://www.w3.org/2000/svg" width="${ size } " height="${ size } " viewBox="0 0 ${ size } ${ size } " fill="none">${ inner } </svg>` ;
4958
5059// The layer sources clip to a 10pt rounded rectangle for the iOS silhouette. Android
5160// applies its own mask, so the layer must bleed to the canvas edge.
@@ -73,6 +82,15 @@ const composite = (
7382 catch : ( cause ) => new AndroidIconRenderError ( { layer, cause } ) ,
7483 } ) ;
7584
85+ const solidCanvas = ( layer : string , size : number , background : string ) =>
86+ Effect . tryPromise ( {
87+ try : ( ) =>
88+ sharp ( { create : { width : size , height : size , channels : 4 , background } } )
89+ . png ( )
90+ . toBuffer ( ) ,
91+ catch : ( cause ) => new AndroidIconRenderError ( { layer, cause } ) ,
92+ } ) ;
93+
7694const readLayerSource = Effect . fn ( "androidIcons.readLayerSource" ) ( function * (
7795 repositoryRoot : string ,
7896 variant : IconVariant ,
@@ -87,36 +105,38 @@ const readLayerSource = Effect.fn("androidIcons.readLayerSource")(function* (
87105
88106const renderForeground = Effect . fn ( "androidIcons.renderForeground" ) ( function * (
89107 repositoryRoot : string ,
108+ size : number ,
90109) {
91110 const text = yield * readLayerSource ( repositoryRoot , "prod" , "text.svg" ) ;
92111 const paths = text . match ( / < p a t h [ ^ > ] * \/ > / g) ?? [ ] ;
93112 return yield * rasterize (
94113 "foreground" ,
95- canvasSvg ( `<g transform="${ wordmarkTransform ( ) } ">${ paths . join ( "" ) } </g>` ) ,
96- CANVAS ,
114+ canvasSvg ( size , `<g transform="${ wordmarkTransform ( size ) } ">${ paths . join ( "" ) } </g>` ) ,
115+ size ,
97116 ) ;
98117} ) ;
99118
100119const renderDevelopmentBackground = Effect . fn ( "androidIcons.renderDevelopmentBackground" ) (
101- function * ( repositoryRoot : string ) {
120+ function * ( repositoryRoot : string , size : number ) {
102121 // The annotation layer shares the wordmark's coordinate space, so it is scaled and
103122 // centered the same way to keep the dimension lines around the letters.
104123 const annotations = yield * readLayerSource ( repositoryRoot , "dev" , "annotations.svg" ) ;
105124 const defs = annotations . match ( / < d e f s > [ \s \S ] * ?< \/ d e f s > / ) ?. [ 0 ] ?? "" ;
106125 const body = annotations . replace ( / ^ [ \s \S ] * ?< \/ d e f s > / , "" ) . replace ( / < \/ s v g > \s * $ / , "" ) ;
107126 const paper = yield * readLayerSource ( repositoryRoot , "dev" , "background.svg" ) ;
108- const background = yield * rasterize ( "dev-background" , fullBleed ( paper ) , CANVAS ) ;
127+ const background = yield * rasterize ( "dev-background" , fullBleed ( paper ) , size ) ;
109128 const overlay = yield * rasterize (
110129 "dev-annotations" ,
111- canvasSvg ( `${ defs } <g transform="${ wordmarkTransform ( ) } ">${ body } </g>` ) ,
112- CANVAS ,
130+ canvasSvg ( size , `${ defs } <g transform="${ wordmarkTransform ( size ) } ">${ body } </g>` ) ,
131+ size ,
113132 ) ;
114133 return yield * composite ( "dev-background" , background , [ { input : overlay } ] ) ;
115134 } ,
116135) ;
117136
118137const renderNightlyBackground = Effect . fn ( "androidIcons.renderNightlyBackground" ) ( function * (
119138 repositoryRoot : string ,
139+ size : number ,
120140) {
121141 // Positions mirror assets/nightly/app-icon.icon/icon.json. The SVG blur filter is
122142 // dropped because Icon Composer ignores it and it smears at this raster size.
@@ -128,7 +148,7 @@ const renderNightlyBackground = Effect.fn("androidIcons.renderNightlyBackground"
128148 translation : [ 387.9605131881942 , - 134.30064713259117 ] ,
129149 } ,
130150 ] as const ;
131- const k = CANVAS / COMPOSER_CANVAS_PT ;
151+ const k = size / COMPOSER_CANVAS_PT ;
132152 const overlays = yield * Effect . forEach ( clouds , ( cloud ) =>
133153 Effect . gen ( function * ( ) {
134154 const width = Math . round ( 64 * cloud . scale * k ) ;
@@ -144,8 +164,8 @@ const renderNightlyBackground = Effect.fn("androidIcons.renderNightlyBackground"
144164 ) ;
145165 const x0 = Math . max ( 0 , left ) ;
146166 const y0 = Math . max ( 0 , top ) ;
147- const x1 = Math . min ( CANVAS , left + width ) ;
148- const y1 = Math . min ( CANVAS , top + height ) ;
167+ const x1 = Math . min ( size , left + width ) ;
168+ const y1 = Math . min ( size , top + height ) ;
149169 const clipped = yield * Effect . tryPromise ( {
150170 try : ( ) =>
151171 sharp ( png )
@@ -158,18 +178,51 @@ const renderNightlyBackground = Effect.fn("androidIcons.renderNightlyBackground"
158178 } ) ,
159179 ) ;
160180 const sky = yield * readLayerSource ( repositoryRoot , "nightly" , "background.svg" ) ;
161- const background = yield * rasterize ( "nightly-background" , fullBleed ( sky ) , CANVAS ) ;
181+ const background = yield * rasterize ( "nightly-background" , fullBleed ( sky ) , size ) ;
162182 return yield * composite ( "nightly-background" , background , overlays ) ;
163183} ) ;
164184
185+ const renderBackground = Effect . fn ( "androidIcons.renderBackground" ) ( function * (
186+ repositoryRoot : string ,
187+ variant : IconVariant ,
188+ size : number ,
189+ ) {
190+ switch ( variant ) {
191+ case "dev" :
192+ return yield * renderDevelopmentBackground ( repositoryRoot , size ) ;
193+ case "nightly" :
194+ return yield * renderNightlyBackground ( repositoryRoot , size ) ;
195+ case "prod" :
196+ return yield * solidCanvas ( "prod-background" , size , PRODUCTION_BACKGROUND_COLOR ) ;
197+ }
198+ } ) ;
199+
200+ const renderSplashIcon = Effect . fn ( "androidIcons.renderSplashIcon" ) ( function * (
201+ repositoryRoot : string ,
202+ variant : IconVariant ,
203+ ) {
204+ const background = yield * renderBackground ( repositoryRoot , variant , SPLASH_CANVAS ) ;
205+ const foreground = yield * renderForeground ( repositoryRoot , SPLASH_CANVAS ) ;
206+ return yield * composite ( `${ variant } -splash` , background , [ { input : foreground } ] ) ;
207+ } ) ;
208+
165209const exportAndroidIcons = Effect . gen ( function * ( ) {
166210 const fs = yield * FileSystem . FileSystem ;
167211 const path = yield * Path . Path ;
168212 const repositoryRoot = path . resolve ( import . meta. dirname , ".." ) ;
169213 const outputs = [
170- [ "android-icon-foreground.png" , yield * renderForeground ( repositoryRoot ) ] ,
171- [ "android-icon-background-dev.png" , yield * renderDevelopmentBackground ( repositoryRoot ) ] ,
172- [ "android-icon-background-nightly.png" , yield * renderNightlyBackground ( repositoryRoot ) ] ,
214+ [ "android-icon-foreground.png" , yield * renderForeground ( repositoryRoot , ADAPTIVE_CANVAS ) ] ,
215+ [
216+ "android-icon-background-dev.png" ,
217+ yield * renderDevelopmentBackground ( repositoryRoot , ADAPTIVE_CANVAS ) ,
218+ ] ,
219+ [
220+ "android-icon-background-nightly.png" ,
221+ yield * renderNightlyBackground ( repositoryRoot , ADAPTIVE_CANVAS ) ,
222+ ] ,
223+ [ "android-splash-icon-dev.png" , yield * renderSplashIcon ( repositoryRoot , "dev" ) ] ,
224+ [ "android-splash-icon-nightly.png" , yield * renderSplashIcon ( repositoryRoot , "nightly" ) ] ,
225+ [ "android-splash-icon-prod.png" , yield * renderSplashIcon ( repositoryRoot , "prod" ) ] ,
173226 ] as const ;
174227 for ( const [ name , contents ] of outputs ) {
175228 yield * fs . writeFile ( path . join ( repositoryRoot , OUTPUT_DIRECTORY , name ) , contents ) ;
0 commit comments