Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Jesus-Puertos/h-ayuntamiento/llms.txt

Use this file to discover all available pages before exploring further.

​
What is Ayuntamiento de Zongolica?

The Ayuntamiento de Zongolica is a comprehensive digital platform that serves as the official government portal and tourism system for the municipality of Zongolica, Veracruz, Mexico. This modern web application bridges government services with cultural preservation and tourism promotion.

​
Key Capabilities

The platform combines two core systems:

Government Portal

Access municipal services, institutional information, transparency documents, and administrative procedures all in one place.

Tourism System

Discover Zongolica’s natural wonders through personalized recommendations, interactive onboarding, and gamified exploration.

​
Government Services

  • Institutional Information - Learn about the municipal president, council members, and government structure
  • Municipal Services - Access online procedures, permits, and administrative services
  • Transparency - Download official documents, reports, and public information
  • Directory - Contact information for government officials and departments
  • Call-to-Action Pages - Important announcements and citizen alerts

​
Tourism Platform

  • Xochitlanis - Interactive tourism onboarding with personalized route recommendations
  • 17 Tourist Attractions - Comprehensive guide to waterfalls, caves, viewpoints, and cultural sites
  • Badge Gamification - Unlock achievements by visiting attractions and completing challenges
  • Ticket Generation - Create shareable visual tickets with personalized routes
  • User Profiles - Save favorites, track visits, and build your travel history

​
Target Users

Citizens

Access government services, perform online procedures, and stay informed about municipal activities.

Tourists

Discover attractions, plan personalized routes, and explore Zongolica’s natural and cultural heritage.

Developers

Build on top of the platform’s modern architecture and integrate with government services.

​
Tech Stack Overview

The platform is built with modern web technologies optimized for performance and user experience:
package.json
{
  "name": "h-ayuntamiento-zongo",
  "type": "module",
  "version": "0.0.1"
}

​
Core Technologies

Astro

Server-side rendering frameworkFast, content-focused architecture with support for React islands and multi-language routing.

React

Interactive componentsUsed for dynamic UI elements like the tourism onboarding flow and authentication system.

Supabase

Backend as a ServicePostgreSQL database, authentication (OAuth), storage for tickets, and real-time capabilities.

Vercel

Deployment platformServerless functions, edge network, and automatic deployments from Git.

​
Supporting Technologies

  • TailwindCSS - Utility-first CSS framework with custom design system
  • Three.js - 3D graphics for immersive visual experiences
  • GSAP - Professional-grade animations
  • Motion - Advanced animation library for React components
  • PhotoSwipe - Responsive image gallery
  • QRCode - Generate shareable codes for routes
  • Satori - Convert HTML to images for social sharing

​
Multi-language Support

The platform serves a diverse community with three language options:
1

Spanish (es)

Default language for the majority of users
2

English (en)

For international tourists and visitors
3

Nahuatl (nah-MX)

Preserving indigenous language and culture of the region
Language routing is configured in astro.config.mjs with automatic locale detection and SEO-friendly URLs.

​
Architecture Highlights

  • Server-Side Rendering (SSR) - Dynamic content generation for optimal performance
  • Island Architecture - Hydrate only interactive components
  • Type Safety - Full TypeScript support across the codebase
  • Responsive Design - Mobile-first approach with adaptive layouts
  • Accessibility - WCAG compliant components and semantic HTML
  • SEO Optimized - Meta tags, structured data, and sitemap generation

​
Getting Started

Quickstart

Get the platform running locally in under 5 minutes

Installation

Complete setup guide with all dependencies and configuration

​
Project Context

Zongolica is located in the mountainous region of central Veracruz, Mexico, known for its:
  • Natural Beauty - Waterfalls, caves, natural arches, and pristine rivers
  • Indigenous Culture - Strong Nahuatl-speaking community with preserved traditions
  • Adventure Tourism - Rappelling, caving, hiking, and eco-tourism opportunities
  • Religious Heritage - Colonial-era churches and sacred sites
This platform helps preserve and promote Zongolica’s unique identity while modernizing government services for its citizens.
This documentation covers the technical implementation. For user-facing guides, visit the official portal at your deployment URL.

Build docs developers (and LLMs) love

Get started for freeTalk to us