Skip to content
⚠️ This article was written in 2020. Some content may be outdated.

Capacitor Cross-Platform App Development

I recently rolled out Capacitor for cross-platform app development on my team and learned a lot along the way. I'm writing this up as a reference, hoping it helps anyone doing similar work.

Core Concepts ​

Building on that, we can push the optimization a step further:

javascript
import React, { useState, useCallback } from 'react'
import { View, Text, FlatList, TouchableOpacity, StyleSheet } from 'react-native'

const ItemList = ({ data, onRefresh }) => {
  const [refreshing, setRefreshing] = useState(false)
  const handleRefresh = useCallback(async () => {
    setRefreshing(true)
    await onRefresh()
    setRefreshing(false)
  }, [onRefresh])

  const renderItem = useCallback(({ item }) => (
    <TouchableOpacity style={styles.item}>
      <Text style={styles.title}>{item.title}</Text>
    </TouchableOpacity>
  ), [])

  return (
    <FlatList data={data} renderItem={renderItem}
      keyExtractor={item => item.id}
      refreshing={refreshing} onRefresh={handleRefresh} />
  )
}

This pattern is very practical in larger projects and significantly lowers maintenance cost.

In-Depth Analysis ​

In real projects the usage gets a bit more involved:

javascript
FROM node:20-alpine AS deps
WORKDIR /app
COPY package.json pnpm-lock.yaml ./
RUN corepack enable && pnpm install --frozen-lockfile

FROM node:20-alpine AS builder
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
RUN pnpm build

FROM nginx:alpine AS runner
COPY --from=builder /app/dist /usr/share/nginx/html
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

This approach improves both the testability and extensibility of the code.

Implementation Experience ​

Here is a complete example:

javascript
import React, { useState, useCallback } from 'react'
import { View, Text, FlatList, TouchableOpacity, StyleSheet } from 'react-native'

const ItemList = ({ data, onRefresh }) => {
  const [refreshing, setRefreshing] = useState(false)
  const handleRefresh = useCallback(async () => {
    setRefreshing(true)
    await onRefresh()
    setRefreshing(false)
  }, [onRefresh])

  const renderItem = useCallback(({ item }) => (
    <TouchableOpacity style={styles.item}>
      <Text style={styles.title}>{item.title}</Text>
    </TouchableOpacity>
  ), [])

  return (
    <FlatList data={data} renderItem={renderItem}
      keyExtractor={item => item.id}
      refreshing={refreshing} onRefresh={handleRefresh} />
  )
}

Pay close attention to edge-case handling — that is critical in production.

Tuning Strategies ​

The key is to understand the core logic:

javascript
FROM node:20-alpine AS deps
WORKDIR /app
COPY package.json pnpm-lock.yaml ./
RUN corepack enable && pnpm install --frozen-lockfile

FROM node:20-alpine AS builder
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
RUN pnpm build

FROM nginx:alpine AS runner
COPY --from=builder /app/dist /usr/share/nginx/html
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

Performance tuning has to fit the actual scenario; not every case needs over-optimization.

Important Notes ​

Here are a few ways we can improve on this:

javascript
import React, { useState, useCallback } from 'react'
import { View, Text, FlatList, TouchableOpacity, StyleSheet } from 'react-native'

const ItemList = ({ data, onRefresh }) => {
  const [refreshing, setRefreshing] = useState(false)
  const handleRefresh = useCallback(async () => {
    setRefreshing(true)
    await onRefresh()
    setRefreshing(false)
  }, [onRefresh])

  const renderItem = useCallback(({ item }) => (
    <TouchableOpacity style={styles.item}>
      <Text style={styles.title}>{item.title}</Text>
    </TouchableOpacity>
  ), [])

  return (
    <FlatList data={data} renderItem={renderItem}
      keyExtractor={item => item.id}
      refreshing={refreshing} onRefresh={handleRefresh} />
  )
}

This approach has been running stably in production for over half a year, so it is battle-tested.

Summary ​

  • Understanding the fundamentals matters more than memorizing APIs.
  • Always verify compatibility before shipping to production.
  • In team collaboration, conventions and documentation matter more than the tech itself.
  • Keep an eye on the community — technical solutions need to keep evolving.

MIT Licensed