Code-Activated Native Features

// Print the current page
NativePrint.printPage();

// Print a PDF from URL
NativePrint.printPDF({ url: 'https://example.com/invoice.pdf' });

// Print custom HTML
NativePrint.printHTML({ html: '<h1>Invoice #1024</h1><p>Amount due: $49.00</p>' });

// Open the native share sheet
NativeUI.share({
  title: 'Check this out',
  text: 'I found this on the app.',
  url: 'https://example.com/product/42',
});

// Show a native alert
NativeUI.alert({ title: 'Saved', message: 'Your changes have been saved.' });

// Show a native confirm dialog
NativeUI.confirm({
  title: 'Delete item?',
  message: 'This action cannot be undone.',
  confirmText: 'Delete',
  cancelText: 'Cancel',
  onConfirm: () => deleteItem(),
});

NativeQRScanner.scan({
  onSuccess: (result) => {
    console.log('Scanned:', result.value, result.format);
    // result.format: 'QR_CODE' | 'EAN_13' | 'CODE_128' etc.
  },
  onCancel: () => console.log('Scanner dismissed'),
});

NativeDocScanner.scan({
  onSuccess: (result) => {
    // result.imageBase64 is a base64-encoded JPEG
    uploadDocument(result.imageBase64);
  },
});

NativeVoice.start({
  language: 'en-US',
  onResult: (transcript) => {
    document.getElementById('search-input').value = transcript;
  },
  onEnd: () => console.log('Recording finished'),
});

// Stop recording manually
NativeVoice.stop();

// Open an address
NativeMaps.open({ address: '1 Infinite Loop, Cupertino, CA' });

// Open coordinates with navigation
NativeMaps.open({
  latitude: 37.3318,
  longitude: -122.0312,
  navigate: true,
});

NativeDownload.download({
  url: 'https://example.com/report.pdf',
  filename: 'Q1-Report.pdf',
  onProgress: (percent) => updateProgressBar(percent),
  onComplete: () => showToast('Download complete'),
});

NativeFileUpload.pick({
  type: 'image', // 'image' | 'document' | 'any'
  onSelect: (file) => {
    const formData = new FormData();
    formData.append('avatar', file.blob, file.name);
    fetch('/api/upload', { method: 'POST', body: formData });
  },
});

NativeMediaPlayer.play({
  url: 'https://example.com/podcast-episode-12.mp3',
  title: 'Episode 12 — Building Mobile Apps',
  artist: 'Dev Podcast',
  coverImage: 'https://example.com/cover.jpg',
});

NativeMediaPlayer.pause();
NativeMediaPlayer.stop();

NativeScreenshot.capture({
  onSuccess: (result) => {
    // result.imageBase64 contains the PNG screenshot
    shareScreenshot(result.imageBase64);
  },
});

NativeNotifications.schedule({
  title: 'Your order has shipped',
  body: 'Order #5821 is on its way. Tap to track.',
  delaySeconds: 3600, // fire in 1 hour
  data: { orderId: '5821' },
});

// A good moment: after a user completes their 5th task
if (user.completedTasks === 5) {
  NativeRating.requestReview();
}

NativeMessaging.show({
  title: 'New feature available',
  message: 'You can now export reports as PDF directly from the dashboard.',
  ctaText: 'Try it now',
  onCta: () => router.push('/reports'),
});

// Write a value
await NativeDatastore.set({ key: 'theme', value: 'dark' });

// Read a value
const theme = await NativeDatastore.get({ key: 'theme' });
console.log(theme.value); // 'dark'

// Remove a value
await NativeDatastore.remove({ key: 'theme' });

// Store a secret
await NativeSecurity.setSecret({ key: 'api_token', value: userToken });

// Retrieve a secret
const { value } = await NativeSecurity.getSecret({ key: 'api_token' });

// Check for root / jailbreak
const { compromised } = await NativeSecurity.isDeviceCompromised();
if (compromised) {
  showSecurityWarning();
}

NativeAnalytics.logEvent({
  name: 'purchase_completed',
  params: {
    item_id: 'plan_pro',
    value: 49.00,
    currency: 'USD',
  },
});

const info = await NativeDevice.getInfo();
// info.platform: 'ios' | 'android'
// info.isTablet: boolean
// info.screenWidth: number
// info.screenHeight: number
// info.orientation: 'portrait' | 'landscape'

if (info.isTablet) {
  enableTabletLayout();
}

const status = await NativeConnectivity.getStatus();
// status.type: 'wifi' | 'cellular' | 'none'
// status.vpnActive: boolean

if (status.type === 'none') {
  showOfflineBanner();
}

// Run a speed test
const speed = await NativeConnectivity.speedTest();
console.log(`Download: ${speed.downloadMbps} Mbps`);

NativeNavigation.setTitle({ title: 'My Orders' });

NativeNavigation.openDrawer();
NativeNavigation.closeDrawer();

NativeTabBar.setTabs([
  { id: 'home', label: 'Home', icon: 'house' },
  { id: 'orders', label: 'Orders', icon: 'bag' },
  { id: 'profile', label: 'Profile', icon: 'person' },
]);

NativeTabBar.onTabSelect((tabId) => {
  router.push(`/${tabId}`);
});

NativeSidebar.setItems([
  { id: 'dashboard', label: 'Dashboard', icon: 'gauge' },
  { id: 'settings', label: 'Settings', icon: 'gear' },
  { id: 'help', label: 'Help', icon: 'question-circle' },
]);

NativeSidebar.onItemSelect((itemId) => {
  router.push(`/${itemId}`);
});

NativeSearch.show({
  placeholder: 'Search products…',
  onSearch: (query) => filterProducts(query),
  onCancel: () => clearSearch(),
});

NativeOnboarding.show({
  steps: [
    { title: 'Welcome', body: 'Track your orders in one place.', image: 'onboarding-1' },
    { title: 'Get notified', body: 'Enable push notifications to stay updated.', image: 'onboarding-2' },
    { title: "You're set", body: 'Tap Get started to open the app.', image: 'onboarding-3' },
  ],
  onComplete: () => router.push('/dashboard'),
});

const { contacts } = await NativeContacts.getAll();
contacts.forEach((c) => {
  console.log(c.name, c.phone);
});

NativeCalendar.addEvent({
  title: 'Team standup',
  startDate: '2026-04-15T09:00:00',
  endDate: '2026-04-15T09:30:00',
  notes: 'Daily 9 am standup via the app.',
});

NativeOffline.onStatusChange((status) => {
  if (status === 'offline') {
    showBanner('You are offline. Some features may be unavailable.');
  } else {
    hideBanner();
  }
});

await NativeOTA.checkForUpdate();
// Returns { available: boolean, version: string }

await NativeOTA.applyUpdate();
// Downloads and applies the update, then restarts the web layer

// Preload likely next pages
NativePerformance.preload(['https://yourapp.com/checkout', 'https://yourapp.com/profile']);

// Clear the cache (useful after a user logs out)
NativePerformance.clearCache();

NativeAppLinks.onDeepLink((url) => {
  // url: the full URL that was opened, e.g. 'https://yourapp.com/orders/5821'
  const path = new URL(url).pathname;
  router.push(path);
});

NativeBeacon.startScanning({
  uuids: ['E2C56DB5-DFFB-48D2-B060-D0F5A71096E0'],
  onBeaconDetected: (beacon) => {
    console.log(`Beacon ${beacon.major}:${beacon.minor} — distance: ${beacon.proximity}`);
  },
});

NativeBeacon.stopScanning();

NativeShareInto.onReceive((payload) => {
  // payload.type: 'url' | 'text' | 'image' | 'file'
  if (payload.type === 'url') {
    router.push(`/save?url=${encodeURIComponent(payload.value)}`);
  }
});