Installing PARKINMX

This comprehensive guide covers installation on all supported platforms: iOS, Android, and Web. Choose your platform below for detailed instructions.

System Requirements

Before installing, ensure your device meets these minimum requirements:

iOS
Android
Web

iOS Requirements

iOS Version: 13.0 or later
Devices: iPhone, iPad, iPod touch
Storage: Minimum 100 MB free space
Internet: WiFi or cellular data connection
Optional: Touch ID or Face ID for biometric login

Compatible Devices

iPhone 6s and newer
iPad Air 2 and newer
iPad mini 4 and newer
iPad Pro (all models)
iPod touch (7th generation)

PARKINMX supports both portrait and landscape orientations on iPad.

Android Requirements

Android Version: 5.0 (Lollipop) or later
Storage: Minimum 100 MB free space
RAM: Minimum 2 GB recommended
Internet: WiFi or mobile data connection
Optional: Fingerprint sensor for biometric login

Permissions Required

The app requests these permissions:

USE_BIOMETRIC - For fingerprint/face authentication
USE_FINGERPRINT - Legacy fingerprint support
CAMERA - For QR code scanning (granted at runtime)
INTERNET - For app functionality

PARKINMX is optimized for edge-to-edge displays and supports Android’s predictive back gesture.

Platform Installation

iOS
Android
Web

Installing on iOS

Open App Store

Locate and tap the App Store icon on your home screen
The App Store app is pre-installed on all iOS devices

Make sure you’re signed in with your Apple ID before downloading apps.

Search for PARKINMX

Tap the Search tab at the bottom of the screen
Type “PARKINMX” in the search bar
Tap Search on the keyboard
Look for the PARKINMX app with the yellow and black icon

The app icon features the PARKINMX logo on a light blue background (#E6F4FE).

Download the App

Tap the Get button next to PARKINMX
Authenticate with Face ID, Touch ID, or Apple ID password
The button changes to show download progress
Wait for installation to complete (typically 30-60 seconds)

The app will automatically appear on your home screen when installation is complete.

Launch and Set Up

Tap the PARKINMX icon on your home screen
You’ll see the splash screen with the PARKINMX logo
After 2 seconds, you’ll be taken to the login screen
Choose “Regístrate” to create a new account or “ENTRAR” to log in

First Launch Permissions

On first launch, the app may request:

Notifications: Tap “Allow” to receive reservation updates and reminders
Camera (when needed): Required for QR code scanning at parking facilities
Biometric Authentication: Set up Touch ID or Face ID for quick login

Grant camera permission when prompted - it’s essential for scanning parking QR codes.

Configure Biometric Login (Optional)

Enable Face ID or Touch ID for faster authentication:

After first login, tap “Enable Biometric Login” when prompted
Follow the on-screen instructions
Your biometric data is stored securely on-device only

Supported methods:

Face ID - iPhone X and newer, iPad Pro (2018+)
Touch ID - iPhone 5s through iPhone 8, iPad with Home button

iOS-Specific Features

PARKINMX takes full advantage of iOS capabilities:

Face ID / Touch ID

Biometric authentication using Apple’s secure enclave. Your biometric data never leaves your device.

iPad Optimization

Full tablet support with adaptive layouts. Use PARKINMX in Split View or Slide Over multitasking.

Dynamic Type

Respects iOS system font size preferences for better accessibility.

Dark Mode

Automatically switches between light and dark themes based on system settings.

Troubleshooting iOS Installation

App Store says 'Cannot Download'

Solutions:

Check your internet connection (try WiFi instead of cellular)
Ensure you have enough storage space (Settings → General → iPhone Storage)
Sign out and back into App Store (Settings → Your Name → Media & Purchases)
Restart your device
Update iOS to the latest version (Settings → General → Software Update)

Face ID / Touch ID not working

Check these settings:

Go to Settings → Face ID & Passcode (or Touch ID & Passcode)
Ensure PARKINMX is listed and enabled
Try disabling and re-enabling biometric login in the app
Make sure your device’s biometric sensor is clean and unobstructed

App crashes on launch

Try these fixes:

Force close the app (swipe up from bottom or double-click Home)
Restart your device
Delete and reinstall the app
Check if iOS update is available
Report the issue via GitHub if problem persists

Camera permission denied

To grant camera access:

Open Settings → Privacy & Security → Camera
Find PARKINMX in the list
Toggle the switch to ON (green)
Relaunch PARKINMX

Installing on Android

Open Google Play Store

Locate and tap the Google Play Store icon in your app drawer
The Play Store is pre-installed on most Android devices
Ensure you’re signed in with your Google account

Some devices may have alternative app stores. PARKINMX is distributed through Google Play Store.

Search for PARKINMX

Tap the search bar at the top of the screen
Type “PARKINMX”
Tap the search icon or press Enter
Select the PARKINMX app from search results

App Identifier:

Package: com.alejandromv03.parkinmx
Developer: alejandromv03

Install the Application

Tap the green Install button
Review the permissions requested
Tap Accept to begin download
Wait for installation to complete (30-90 seconds depending on connection)

The app icon will appear in your app drawer when ready.

The app requires approximately 50-100 MB download. Use WiFi to avoid cellular data charges.

Grant Initial Permissions

When you first open PARKINMX, you’ll be asked to grant permissions:Required at installation:

USE_BIOMETRIC - For fingerprint authentication
USE_FINGERPRINT - Legacy fingerprint support

Requested at runtime (when needed):

Camera - When you scan a QR code
Notifications - For reservation alerts

You can change permissions later in Settings → Apps → PARKINMX → Permissions.

First Launch Setup

Tap the PARKINMX icon to launch
Watch the 2-second splash screen
Arrive at the login screen
Tap “Regístrate” to create your account

Enable Biometric Authentication

After first login, set up fingerprint or face unlock:

Tap “Enable Biometric Login” when prompted
Follow your device’s biometric setup
Test the biometric login by logging out and back in

Supported biometric methods:

Fingerprint sensor
Face unlock (on supported devices)
Iris scanner (on Samsung devices)

Android-Specific Features

Adaptive Icons

Dynamic app icons that adapt to your device’s icon shape and theme. Includes monochrome variant for themed icons.

Edge-to-Edge Display

Full immersive experience using the entire screen, including notch and camera cutout areas.

Predictive Back Gesture

Smooth back navigation with visual preview of where you’ll go when swiping back.

Dark Mode

Automatic theme switching based on system settings. Battery-friendly OLED optimizations.

Android Version Compatibility

PARKINMX is tested on these Android versions:

Android Version	Codename	Support Status
13+	Tiramisu & newer	✅ Fully supported
10-12	Q, R, S	✅ Fully supported
8-9	Oreo, Pie	✅ Supported
5-7	Lollipop, Marshmallow, Nougat	⚠️ Basic support
< 5	KitKat and older	❌ Not supported

Some advanced features may be limited on Android 5-7. Update to Android 8+ for the best experience.

Troubleshooting Android Installation

Play Store won't download the app

Common solutions:

Clear Play Store cache: Settings → Apps → Play Store → Storage → Clear Cache
Check internet connection (switch between WiFi and mobile data)
Ensure sufficient storage space (Settings → Storage)
Update Google Play Store to latest version
Remove and re-add your Google account
Restart your device

Installation pending or stuck

Try these steps:

Open Play Store → Menu → My apps & games
Find PARKINMX in the queue
Tap to cancel and retry
Clear Play Store data: Settings → Apps → Play Store → Storage → Clear Data
Reboot device and try again

Fingerprint authentication not working

Check settings:

Go to Settings → Security → Fingerprint
Ensure fingerprint is enrolled
In PARKINMX, go to Menu → Security
Toggle biometric login off and on again
Make sure sensor is clean and dry

Camera permission denied

To manually grant camera access:

Open Settings → Apps → PARKINMX
Tap Permissions
Find Camera and tap it
Select Allow or Allow only while using the app
Return to PARKINMX and try again

App not compatible with device

Possible reasons:

Your Android version is below 5.0
Your device architecture is not supported (very rare)
Regional restrictions (contact support)

Solutions:

Update Android to the latest available version
Check device specifications
Try sideloading (advanced users only)

Installing from APK (Advanced)

If Play Store is unavailable, you can install via APK:

Only download APKs from official sources. Installing from untrusted sources poses security risks.

Download APK

Download the official PARKINMX APK from:

GitHub releases
Official website
Expo build artifacts (if you have access)

Enable Unknown Sources

Go to Settings → Security
Enable “Install from Unknown Sources” or “Install Unknown Apps”
Grant permission to your browser or file manager

Install APK

Open the downloaded APK file
Tap Install
Wait for installation to complete
Tap Open to launch

Using PARKINMX on Web

The web version provides full functionality without requiring installation.

Access the Web App

Open your preferred web browser
Navigate to your PARKINMX deployment URL
Bookmark the page for quick access

Supported Browsers:

✅ Chrome 90+
✅ Safari 14+
✅ Firefox 88+
✅ Edge 90+
✅ Opera 76+
⚠️ Internet Explorer: Not supported

The web version is built as a static Progressive Web App (PWA) using Expo’s web output.

Install as PWA (Optional)

For a native app-like experience, install PARKINMX to your home screen:

Chrome (Desktop)
Safari (iOS)
Chrome (Android)
Firefox

Click the install icon (⊕) in the address bar
Click Install in the dialog
PARKINMX opens in its own window
Access from your taskbar or desktop shortcut

PWA installation gives you offline access to previously loaded content and faster load times.

Create Your Account

On the login screen, click “Regístrate”
Fill in your email, username, and password
Click REGISTRARSE
Verify your email if prompted

The web version uses the same Firebase backend as mobile apps - your account works across all platforms.

Enable Browser Features

For the best experience, enable these browser features:Notifications:

Click Allow when prompted for notifications
Or enable in browser settings: Site Settings → Notifications

Location (for “Get Directions”):

Allow location access when prompted
Required for the “Cómo llegar” (directions) feature

Camera (for QR scanning):

Grant camera permission when scanning QR codes
Check browser settings if camera doesn’t work

Web-Specific Features

Responsive Design

Fully responsive layout that adapts from mobile (320px) to desktop (1920px+) screens.

Cross-Device Sync

Changes sync in real-time across all your devices via Firebase.

No Installation Required

Access instantly from any device with a browser. No storage space needed.

Automatic Updates

Always use the latest version - updates are instant and automatic.

Browser Compatibility Details

Required Browser Features

PARKINMX web requires these modern browser capabilities:

Browser Features

// Required JavaScript features (ES6+)
- Arrow functions
- Async/await
- Promises
- Template literals
- Destructuring
- Modules (import/export)

// Required Web APIs
- Fetch API
- LocalStorage
- SessionStorage
- Geolocation API (for directions)
- Camera API (for QR scanning)
- Notifications API (for alerts)

Performance Optimization

The web version includes:

Code splitting for faster initial load
Asset optimization and compression
Service worker for offline support
Lazy loading of images and components

Troubleshooting Web Access

Page won't load or shows blank screen

Solutions:

Clear browser cache and cookies
Hard refresh: Ctrl+Shift+R (Windows) or Cmd+Shift+R (Mac)
Disable browser extensions temporarily
Try incognito/private mode
Update browser to latest version
Try a different browser

Features not working as expected

Check these items:

JavaScript is enabled (it must be on)
No aggressive ad blockers interfering
Browser is up to date
Stable internet connection
Console errors (F12 → Console tab)

Camera/QR scanner not working

Common issues:

Camera permission was denied:
- Chrome: Click the lock icon in address bar → Site Settings → Camera → Allow
- Safari: Safari menu → Settings for This Website → Camera → Allow
Camera is in use by another app
Browser doesn’t support getUserMedia API (very old browsers)
Try HTTPS connection (camera requires secure context)

Can't receive notifications

Enable notifications:

Check site permissions: Browser settings → Site Settings → Notifications
Ensure notifications are not blocked at OS level
Re-grant permission: Click the bell icon when prompted
Check browser notification settings

Slow performance on web

Optimization tips:

Close unnecessary browser tabs
Clear browser cache
Disable heavy browser extensions
Check your internet speed
Use a modern browser (Chrome/Safari/Firefox latest)
Close other applications using memory

Desktop App Experience

When installed as a PWA on desktop:

Standalone window - Runs in its own window without browser UI
Dock/Taskbar icon - Quick access like a native app
Keyboard shortcuts - Standard shortcuts work (Cmd+R refresh, etc.)
Notifications - System-level notifications when app is closed
Offline mode - Previously loaded data available without internet

Post-Installation Setup

After installing on any platform, complete these initial setup steps:

Create Account

Add Vehicle

Add at least one vehicle to your garage. See Managing Vehicles guide.

Set Up Payment

Add a payment method or load wallet balance. See Payment Methods guide.

Configure Security PIN

Create your 4-digit transaction PIN in Wallet → Security settings.

Enable Notifications

Allow notifications to receive reservation updates and reminders.

Development Installation

For developers wanting to run PARKINMX locally:

Development Setup

Prerequisites

# Required software
- Node.js 18+ and npm
- Expo CLI
- iOS: Xcode 14+ (Mac only)
- Android: Android Studio with SDK

Clone and Install

# Clone the repository
git clone https://github.com/AlejandroMV03/PARKINMX.git
cd PARKINMX

# Install dependencies
npm install

Configure Firebase

Create a Firebase project
Add your Firebase config
Enable Authentication and Firestore

Run Development Server

# Start Expo dev server
npm start

# Or run on specific platform
npm run ios      # iOS simulator
npm run android  # Android emulator
npm run web      # Web browser

See Development → Architecture for complete development setup.

Updating PARKINMX

iOS
Android
Web

Updates are managed through the App Store:

Open App Store
Tap your profile icon (top right)
Scroll to Available Updates
Find PARKINMX and tap Update

Or enable automatic updates:

Settings → App Store → App Updates → ON

Uninstalling PARKINMX

If you need to remove the app:

iOS
Android
Web

Long-press the PARKINMX icon on home screen
Tap Remove App
Choose Delete App
Confirm deletion

Your account data remains on Firebase servers. Reinstalling restores your data.

Next Steps

Quick Start Guide

Complete the setup and make your first reservation in 5 minutes.

Feature Overview

Explore all PARKINMX features and capabilities.

User Guides

Detailed guides for using every feature of PARKINMX.

Support

Get help if you encounter any issues during installation.

Technical Details

App Configuration (app.json)

{
  "expo": {
    "name": "parkinmx",
    "slug": "parkinmx",
    "version": "1.0.0",
    "scheme": "parkinmx",
    "newArchEnabled": true,
    "ios": {
      "supportsTablet": true
    },
    "android": {
      "permissions": [
        "android.permission.USE_BIOMETRIC",
        "android.permission.USE_FINGERPRINT"
      ],
      "edgeToEdgeEnabled": true
    },
    "plugins": [
      "expo-router",
      "expo-secure-store",
      "expo-local-authentication",
      "expo-barcode-scanner"
    ]
  }
}

Dependencies & Versions

Key packages used in PARKINMX:

{
  "expo": "~54.0.27",
  "react": "19.1.0",
  "react-native": "0.81.5",
  "expo-router": "~6.0.17",
  "firebase": "^12.6.0",
  "expo-local-authentication": "~17.0.8",
  "expo-barcode-scanner": "^13.0.1",
  "expo-secure-store": "~15.0.8"
}

See Development → Expo Configuration for full dependency list.

Keep your app updated to the latest version for security patches, bug fixes, and new features.

Installation complete? Head to the Quick Start Guide to begin using PARKINMX!

Getting Started

Core Features

User Guides

Community

​Installing PARKINMX

​System Requirements

​iOS Requirements

​Compatible Devices

​Android Requirements

​Permissions Required

​Web Requirements

​Recommended Specifications

​Platform Installation

​Installing on iOS

​First Launch Permissions

​iOS-Specific Features

Face ID / Touch ID

iPad Optimization

Dynamic Type

Dark Mode

​Troubleshooting iOS Installation

​Installing on Android

​Enable Biometric Authentication

​Android-Specific Features

Adaptive Icons

Edge-to-Edge Display

Predictive Back Gesture

Dark Mode

​Android Version Compatibility

​Troubleshooting Android Installation

​Installing from APK (Advanced)

​Using PARKINMX on Web

​Web-Specific Features

Responsive Design

Cross-Device Sync

No Installation Required

Automatic Updates

​Browser Compatibility Details

​Required Browser Features

​Performance Optimization

​Troubleshooting Web Access

​Desktop App Experience

​Post-Installation Setup

​Development Installation

​Prerequisites

​Clone and Install

​Configure Firebase

​Run Development Server

​Updating PARKINMX

​Uninstalling PARKINMX

​Next Steps

Quick Start Guide

Feature Overview

User Guides

Support

​Technical Details

Build docs developers (and LLMs) love

Installing PARKINMX

System Requirements

iOS Requirements

Compatible Devices

Android Requirements

Permissions Required

Web Requirements

Recommended Specifications

Platform Installation

Installing on iOS

First Launch Permissions

iOS-Specific Features

Troubleshooting iOS Installation

Installing on Android

Enable Biometric Authentication

Android-Specific Features

Android Version Compatibility

Troubleshooting Android Installation

Installing from APK (Advanced)

Using PARKINMX on Web

Web-Specific Features

Browser Compatibility Details

Required Browser Features

Performance Optimization

Troubleshooting Web Access

Desktop App Experience

Post-Installation Setup

Development Installation

Prerequisites

Clone and Install

Configure Firebase

Run Development Server

Updating PARKINMX

Uninstalling PARKINMX

Next Steps

Technical Details