Menu

Change language

GitHub repo

Phone

phoneui

Front device frames for iPhone 17 Pro and Galaxy S26 Ultra. Real chassis aspect ratios (71.9×150 / 78.1×163.6), Dynamic Island / punch-hole, side buttons, status bar, home indicator / gesture bar, and official finish colors. Slot in any screen content.

Installation

$npx uipkge-ng@latest add phone
Manifest:https://uipkge.dev/r/angular/phone.jsonInstalls to:src/app/components/ui/phone/

Examples

Loading interactive previews…

Props

NameType / ValuesDefaultRequired
model
'iphone-17-pro''galaxy-s26-ultra'
iphone-17-prooptional
size
'sm''md''lg'
mdoptional
colorPhoneColor—optional
showStatusBarbooleantrueoptional
timestring9:41optional
showHomeIndicatorboolean—optional
showNavBarboolean—optional
classstring—optional

Schema

Type aliases from this item's source — use them to shape the data you pass in.

Finish
type Finish {
  name: string
  base: string
  highlight: string
  shadow: string
  button: string
}

Files installed (2)

  • src/app/components/ui/phone/phone.component.ts14.2 kB
    import { Component, Input, booleanAttribute, ChangeDetectionStrategy } from '@angular/core'
    import { cn } from '@/lib/utils'
    
    export type PhoneModel = 'iphone-17-pro' | 'galaxy-s26-ultra'
    export type PhoneSize = 'sm' | 'md' | 'lg'
    export type IPhone17ProColor = 'cosmic-orange' | 'deep-blue' | 'silver'
    export type GalaxyS26UltraColor = 'titanium-black' | 'titanium-gray' | 'titanium-silver' | 'cobalt-violet'
    export type PhoneColor = IPhone17ProColor | GalaxyS26UltraColor | 'black' | 'natural' | 'blue'
    
    type Finish = {
      name: string
      base: string
      highlight: string
      shadow: string
      button: string
    }
    
    const SIZE_CLASSES: Record<PhoneSize, string> = {
      sm: 'w-[240px]',
      md: 'w-[300px]',
      lg: 'w-[340px]',
    }
    
    const SIZE_SCALES: Record<PhoneSize, number> = { sm: 0.8, md: 1, lg: 1.133 }
    
    function getFinish(model: PhoneModel, color?: PhoneColor): Finish {
      if (model === 'iphone-17-pro') {
        const selected: IPhone17ProColor =
          color === 'silver'
            ? 'silver'
            : color === 'deep-blue' || color === 'blue' || color === 'black'
              ? 'deep-blue'
              : 'cosmic-orange'
    
        return {
          'cosmic-orange': {
            name: 'Cosmic Orange',
            base: '#d65f27',
            highlight: '#f49a69',
            button: '#bd4e1d',
            shadow: '0 30px 70px -22px rgba(184, 72, 24, 0.62), 0 10px 24px -14px rgba(0, 0, 0, 0.5)',
          },
          'deep-blue': {
            name: 'Deep Blue',
            base: '#183867',
            highlight: '#526f9d',
            button: '#102d56',
            shadow: '0 30px 70px -22px rgba(18, 45, 91, 0.7), 0 10px 24px -14px rgba(0, 0, 0, 0.55)',
          },
          silver: {
            name: 'Silver',
            base: '#b9babd',
            highlight: '#f1f1f2',
            button: '#9b9ca0',
            shadow: '0 30px 70px -24px rgba(0, 0, 0, 0.42), 0 10px 24px -14px rgba(0, 0, 0, 0.38)',
          },
        }[selected]
      }
    
      const selected: GalaxyS26UltraColor =
        color === 'titanium-gray'
          ? 'titanium-gray'
          : color === 'titanium-silver' || color === 'silver' || color === 'natural'
            ? 'titanium-silver'
            : color === 'cobalt-violet' || color === 'blue'
              ? 'cobalt-violet'
              : 'titanium-black'
    
      return {
        'titanium-black': {
          name: 'Titanium Black',
          base: '#242426',
          highlight: '#66666a',
          button: '#171719',
          shadow: '0 30px 68px -22px rgba(0, 0, 0, 0.7), 0 10px 24px -14px rgba(0, 0, 0, 0.65)',
        },
        'titanium-gray': {
          name: 'Titanium Gray',
          base: '#66666a',
          highlight: '#aaa9ad',
          button: '#4a4a4e',
          shadow: '0 30px 68px -24px rgba(0, 0, 0, 0.52), 0 10px 24px -14px rgba(0, 0, 0, 0.5)',
        },
        'titanium-silver': {
          name: 'Titanium Silver',
          base: '#b9babe',
          highlight: '#eeeeef',
          button: '#999a9e',
          shadow: '0 30px 68px -24px rgba(0, 0, 0, 0.4), 0 10px 24px -14px rgba(0, 0, 0, 0.4)',
        },
        'cobalt-violet': {
          name: 'Cobalt Violet',
          base: '#4b3a74',
          highlight: '#8a78b1',
          button: '#352658',
          shadow: '0 30px 68px -22px rgba(48, 31, 86, 0.68), 0 10px 24px -14px rgba(0, 0, 0, 0.55)',
        },
      }[selected]
    }
    
    function getPhoneVars(model: PhoneModel, scale: number, finish: Finish): Record<string, string> {
      const px = (value: number) => `${value * scale}px`
      const common = {
        '--phone-finish': finish.base,
        '--phone-finish-highlight': finish.highlight,
        '--phone-button': finish.button,
        '--phone-button-depth': px(3),
        '--phone-button-radius': px(1.5),
      }
    
      if (model === 'iphone-17-pro') {
        return {
          ...common,
          '--phone-rim': px(2.5),
          '--phone-bezel': px(7.5),
          '--phone-outer-radius': px(44),
          '--phone-bezel-radius': px(41.5),
          '--phone-screen-radius': px(34),
          '--phone-island-width': px(88),
          '--phone-island-height': px(27),
          '--phone-island-top': px(11),
          '--phone-status-height': px(44),
          '--phone-status-padding': px(18),
          '--phone-status-size': px(12),
          '--phone-indicator-height': px(5),
          '--phone-indicator-bottom': px(8),
        }
      }
    
      return {
        ...common,
        '--phone-rim': px(2.2),
        '--phone-bezel': px(5.8),
        '--phone-outer-radius': px(26.9),
        '--phone-bezel-radius': px(24.7),
        '--phone-screen-radius': px(18.9),
        '--phone-camera-size': px(12),
        '--phone-camera-top': px(10),
        '--phone-status-height': px(36),
        '--phone-status-padding': px(16),
        '--phone-status-size': px(12),
        '--phone-indicator-height': px(4),
        '--phone-indicator-bottom': px(8),
      }
    }
    
    /**
     * Angular port of UIPKGE Phone. Front device frames for iPhone 17 Pro and
     * Galaxy S26 Ultra with real chassis aspect ratios, Dynamic Island /
     * punch-hole, side buttons, status bar, and finish colors.
     */
    @Component({
      changeDetection: ChangeDetectionStrategy.Eager,
      selector: 'ui-phone, [ui-phone]',
      standalone: true,
      host: {
        '[attr.data-slot]': '"phone"',
        '[attr.data-uipkge]': '""',
        '[attr.data-model]': 'resolvedModel',
        '[attr.data-size]': 'size',
        '[attr.data-color]': 'dataColor',
        '[attr.role]': '"group"',
        '[attr.aria-label]': 'ariaLabel',
        '[class]': 'hostClass',
        '[style]': 'phoneVars',
      },
      template: `
        <div data-uipkge data-slot="phone-chassis" class="relative w-full" [style]="chassisStyle">
          <div
            aria-hidden="true"
            class="pointer-events-none absolute inset-0 z-30 border border-white/25 shadow-[inset_0_0_1px_1px_rgba(255,255,255,0.18),inset_0_0_3px_rgba(0,0,0,0.5)]"
            style="border-radius: var(--phone-outer-radius)"
          ></div>
    
          @if (isIPhone) {
            <div
              data-slot="phone-action-button"
              data-side="left"
              aria-hidden="true"
              class="absolute top-[15.8%] left-0 h-[4.8%] -translate-x-full bg-[var(--phone-button)] shadow-[inset_1px_0_rgba(255,255,255,0.22)]"
              style="width: var(--phone-button-depth); border-radius: var(--phone-button-radius) 0 0 var(--phone-button-radius)"
            ></div>
            <div
              data-slot="phone-volume-button"
              data-control="up"
              data-side="left"
              aria-hidden="true"
              class="absolute top-[23.3%] left-0 h-[7.2%] -translate-x-full bg-[var(--phone-button)] shadow-[inset_1px_0_rgba(255,255,255,0.22)]"
              style="width: var(--phone-button-depth); border-radius: var(--phone-button-radius) 0 0 var(--phone-button-radius)"
            ></div>
            <div
              data-slot="phone-volume-button"
              data-control="down"
              data-side="left"
              aria-hidden="true"
              class="absolute top-[32.2%] left-0 h-[7.2%] -translate-x-full bg-[var(--phone-button)] shadow-[inset_1px_0_rgba(255,255,255,0.22)]"
              style="width: var(--phone-button-depth); border-radius: var(--phone-button-radius) 0 0 var(--phone-button-radius)"
            ></div>
            <div
              data-slot="phone-side-button"
              data-side="right"
              aria-hidden="true"
              class="absolute top-[24.1%] right-0 h-[12.2%] translate-x-full bg-[var(--phone-button)] shadow-[inset_-1px_0_rgba(255,255,255,0.22)]"
              style="width: var(--phone-button-depth); border-radius: 0 var(--phone-button-radius) var(--phone-button-radius) 0"
            ></div>
            <div
              data-slot="phone-camera-control"
              data-side="right"
              aria-hidden="true"
              class="absolute top-[68.5%] right-0 h-[8.7%] translate-x-full bg-[var(--phone-button)] shadow-[inset_-1px_0_rgba(255,255,255,0.22)]"
              style="width: var(--phone-button-depth); border-radius: 0 var(--phone-button-radius) var(--phone-button-radius) 0"
            ></div>
          } @else {
            <div
              data-slot="phone-volume-button"
              data-side="right"
              aria-hidden="true"
              class="absolute top-[17.2%] right-0 h-[13.8%] translate-x-full bg-[var(--phone-button)] shadow-[inset_-1px_0_rgba(255,255,255,0.22)]"
              style="width: var(--phone-button-depth); border-radius: 0 var(--phone-button-radius) var(--phone-button-radius) 0"
            ></div>
            <div
              data-slot="phone-side-button"
              data-side="right"
              aria-hidden="true"
              class="absolute top-[33.1%] right-0 h-[8.9%] translate-x-full bg-[var(--phone-button)] shadow-[inset_-1px_0_rgba(255,255,255,0.22)]"
              style="width: var(--phone-button-depth); border-radius: 0 var(--phone-button-radius) var(--phone-button-radius) 0"
            ></div>
          }
    
          <div
            data-slot="phone-bezel"
            aria-hidden="true"
            class="absolute bg-[#050506] shadow-[inset_0_0_1px_rgba(255,255,255,0.32)]"
            style="inset: var(--phone-rim); border-radius: var(--phone-bezel-radius)"
          ></div>
    
          <div
            data-uipkge
            data-slot="phone-screen"
            class="bg-background text-foreground absolute overflow-hidden"
            style="inset: calc(var(--phone-rim) + var(--phone-bezel)); border-radius: var(--phone-screen-radius)"
          >
            <div data-slot="phone-content" class="absolute inset-0 z-10 overflow-auto">
              <ng-content />
            </div>
    
            @if (isIPhone) {
              <div
                data-slot="phone-island"
                aria-hidden="true"
                class="absolute left-1/2 z-40 -translate-x-1/2 rounded-full bg-[#050506] shadow-[0_1px_2px_rgba(0,0,0,0.55)]"
                style="top: var(--phone-island-top); width: var(--phone-island-width); height: var(--phone-island-height)"
              >
                <span
                  class="absolute top-1/2 right-[9%] aspect-square h-[36%] -translate-y-1/2 rounded-full bg-[#101929] ring-1 ring-[#172c4a]"
                >
                  <span class="absolute top-[16%] left-[18%] size-[28%] rounded-full bg-white/25"></span>
                </span>
              </div>
            } @else {
              <div
                data-slot="phone-camera"
                aria-hidden="true"
                class="absolute left-1/2 z-40 -translate-x-1/2 rounded-full bg-[#07090c] shadow-[0_0_0_1px_rgba(255,255,255,0.12)]"
                style="top: var(--phone-camera-top); width: var(--phone-camera-size); height: var(--phone-camera-size)"
              >
                <span class="absolute inset-[24%] rounded-full bg-[#11243d]"></span>
              </div>
            }
    
            @if (showStatusBar) {
              <div
                data-uipkge
                data-slot="phone-status-bar"
                aria-hidden="true"
                class="pointer-events-none absolute inset-x-0 top-0 z-30 flex items-center justify-between font-semibold text-current"
                style="height: var(--phone-status-height); padding-inline: var(--phone-status-padding); font-size: var(--phone-status-size)"
              >
                <span class="leading-none tabular-nums">{{ time }}</span>
                <div class="flex items-center gap-[0.28em]">
                  <svg viewBox="0 0 16 12" class="h-[0.78em] w-[1.05em]" fill="currentColor" aria-hidden="true">
                    <path d="M1 11h2V8H1v3Zm4 0h2V6H5v5Zm4 0h2V3H9v8Zm4 0h2V0h-2v11Z" />
                  </svg>
                  <svg viewBox="0 0 16 12" class="h-[0.78em] w-[1.05em]" fill="currentColor" aria-hidden="true">
                    <path
                      d="M8 10.5a1.2 1.2 0 1 0 0 2.4 1.2 1.2 0 0 0 0-2.4ZM3.8 7.3l1.3 1.3a4.1 4.1 0 0 1 5.8 0l1.3-1.3a6 6 0 0 0-8.4 0ZM1 4.5l1.3 1.3a8 8 0 0 1 11.4 0L15 4.5a9.9 9.9 0 0 0-14 0Z"
                    />
                  </svg>
                  <span class="relative h-[0.82em] w-[1.65em] rounded-[0.2em] border-[0.12em] border-current">
                    <span class="absolute inset-[0.13em] right-[28%] rounded-[0.08em] bg-current"></span>
                    <span class="absolute top-[28%] -right-[0.22em] h-[44%] w-[0.12em] rounded-r-full bg-current/65"></span>
                  </span>
                </div>
              </div>
            }
    
            @if ((isIPhone && showHome) || (!isIPhone && showNav)) {
              <div
                data-uipkge
                [attr.data-slot]="isIPhone ? 'phone-home-indicator' : 'phone-nav-bar'"
                aria-hidden="true"
                class="pointer-events-none absolute inset-x-0 z-40 flex justify-center"
                style="bottom: var(--phone-indicator-bottom)"
              >
                <div [class]="indicatorClass" style="height: var(--phone-indicator-height)"></div>
              </div>
            }
    
            <div
              aria-hidden="true"
              class="pointer-events-none absolute inset-0 z-50 shadow-[inset_0_0_0_1px_rgba(0,0,0,0.5)]"
              style="border-radius: var(--phone-screen-radius)"
            ></div>
          </div>
        </div>
      `,
    })
    export class UiPhoneComponent {
      @Input() model: PhoneModel = 'iphone-17-pro'
      @Input() size: PhoneSize = 'md'
      @Input() color?: PhoneColor
      @Input({ transform: booleanAttribute }) showStatusBar = true
      @Input() time = '9:41'
      @Input({ transform: booleanAttribute }) showHomeIndicator?: boolean
      @Input({ transform: booleanAttribute }) showNavBar?: boolean
      @Input('class') className?: string
    
      get resolvedModel(): PhoneModel {
        return this.model === 'galaxy-s26-ultra' ? 'galaxy-s26-ultra' : 'iphone-17-pro'
      }
    
      get isIPhone(): boolean {
        return this.resolvedModel === 'iphone-17-pro'
      }
    
      get sizeClass(): string {
        return SIZE_CLASSES[this.size]
      }
    
      get sizeScale(): number {
        return SIZE_SCALES[this.size]
      }
    
      get finish(): Finish {
        return getFinish(this.resolvedModel, this.color)
      }
    
      get dataColor(): string {
        return this.finish.name.toLowerCase().replaceAll(' ', '-')
      }
    
      get indicatorClass(): string {
        return cn('rounded-full bg-current', this.isIPhone ? 'w-[36%] max-w-[120px]' : 'w-[27%] max-w-[100px] opacity-55')
      }
    
      get showHome(): boolean {
        return this.showHomeIndicator ?? this.isIPhone
      }
    
      get showNav(): boolean {
        return this.showNavBar ?? !this.isIPhone
      }
    
      get ariaLabel(): string {
        return `${this.isIPhone ? 'iPhone 17 Pro' : 'Galaxy S26 Ultra'} preview, ${this.finish.name}`
      }
    
      get aspectRatio(): string {
        return this.isIPhone ? '71.9 / 150' : '78.1 / 163.6'
      }
    
      get phoneVars(): Record<string, string> {
        return getPhoneVars(this.resolvedModel, this.sizeScale, this.finish)
      }
    
      get hostClass(): string {
        return cn('relative inline-block max-w-full select-none', this.sizeClass, this.className)
      }
    
      get chassisStyle(): Record<string, string> {
        return {
          aspectRatio: this.aspectRatio,
          borderRadius: 'var(--phone-outer-radius)',
          background:
            'linear-gradient(115deg, var(--phone-finish-highlight) 0%, var(--phone-finish) 38%, color-mix(in srgb, var(--phone-finish) 72%, black) 100%)',
          boxShadow: this.finish.shadow,
        }
      }
    }
    
  • src/app/components/ui/phone/index.ts0.1 kB

Raw manifest:https://uipkge.dev/r/angular/phone.json