Skip to main content

Overview

Portal Ciudadano Manta is a Vue 3 + TypeScript SPA that can be deployed to various platforms. The application uses Supabase as its backend service.

Prerequisites

Before deploying, ensure you have:

Node.js 16+

Required for building the application

Supabase Account

Free tier available at supabase.com

Environment Variables

Supabase URL and anonymous key configured

Git Repository

For automatic deployments (optional)

Technology Stack

Frontend

TechnologyVersionPurpose
Vue.js3.5+Progressive JavaScript framework
TypeScript5.9+Static type checking
Vite7.1+Ultra-fast build tool
Tailwind CSS4.1+Utility-first CSS framework
Vue Router4.6+SPA routing
Pinia3.0+State management
Vue I18n9.14+Internationalization (ES/EN/QU)
Leaflet1.9+Interactive maps

Backend & Database

TechnologyPurpose
SupabaseBackend as a Service (BaaS)
PostgreSQLRelational database
Row Level SecurityDatabase security policies
Supabase StorageFile storage
Supabase AuthAuthentication & authorization

Deployment Platforms

Netlify

Recommended for automatic GitHub deployments with built-in CI/CD

Vercel

Optimized for modern web frameworks with excellent DX

Build Configuration

Build Command

npm run build
This executes:
vue-tsc -b && vite build

Output Directory

dist/

Build Optimizations

The application is configured with:
  • Code Splitting: Vendor chunks for vue, i18n, supabase, and leaflet
  • Minification: Using esbuild for fast builds
  • Target: ES2015 for broad browser compatibility
  • Chunk Size Warning: 1000kb limit

Browser Compatibility

Chrome 90+

✅ Fully supported

Firefox 88+

✅ Fully supported

Safari 14+

✅ Fully supported

Edge 90+

✅ Fully supported

Opera 76+

✅ Fully supported

Deployment Checklist

1

Configure Supabase

Set up your Supabase project and apply database schemaSee Supabase Setup
2

Set Environment Variables

Configure VITE_SUPABASE_URL and VITE_SUPABASE_ANON_KEYSee Environment Variables
3

Apply Security Policies

Enable Row Level Security and Storage PoliciesSee RLS Policies and Storage Policies
4

Choose Platform

Deploy to Netlify or VercelSee platform-specific guides
5

Test Deployment

Verify authentication, database access, and file uploads work correctly

Next Steps

Supabase Setup

Configure your Supabase backend

Environment Variables

Set up required configuration

Build docs developers (and LLMs) love