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.

​
Get Running Quickly

This guide will have you up and running with the Ayuntamiento de Zongolica platform in under 5 minutes.
This quickstart uses Supabase for authentication and database. You’ll need a free Supabase account to complete setup.
1

Prerequisites

Ensure you have the following installed:
  • Node.js 18.14.1 or higher
  • npm 9.0.0 or higher (comes with Node.js)
  • Git for cloning the repository
Check your versions:
node --version
npm --version
2

Clone the Repository

Clone the source repository to your local machine:
git clone <repository-url>
cd h-ayuntamiento-zongo
3

Install Dependencies

Install all required packages:
npm install
This will install:
  • Astro framework and integrations
  • React and React DOM
  • Supabase client
  • TailwindCSS and UI dependencies
  • Animation libraries (GSAP, Motion)
  • Image processing tools
4

Set Up Environment Variables

Create a .env file in the root directory:
cp .env.example .env
Edit .env with your configuration:
.env
# WordPress (optional for CMS integration)
WP_BASE_URL=

# Email service (optional)
RESEND_API_KEY=
RESEND_FROM=

# Backend secret (optional)
BACKEND_APP_SECRET=

# Notion API (optional)
NOTION_API_MCP=

# Supabase (required for auth and tourism features)
PUBLIC_SUPABASE_URL=https://your-project.supabase.co
PUBLIC_SUPABASE_ANON_KEY=your-anon-key

# OpenAI (optional for AI features)
OPENAI_API_KEY=
At minimum, configure PUBLIC_SUPABASE_URL and PUBLIC_SUPABASE_ANON_KEY to enable authentication and tourism features.
5

Configure Supabase (Optional but Recommended)

If you want to use the tourism system:
  1. Create a free account at supabase.com
  2. Create a new project
  3. Go to Settings > API and copy:
    • Project URL → PUBLIC_SUPABASE_URL
    • anon/public key → PUBLIC_SUPABASE_ANON_KEY
  4. Go to SQL Editor and run the setup script (see Installation for full SQL)
The platform will still run without Supabase, but authentication and tourism features will be disabled.
6

Run the Development Server

Start the Astro development server:
npm run dev
You should see output like:
🚀  astro  v5.16.6 started in 123ms

┃ Local    http://localhost:4321/
┃ Network  use --host to expose
7

Access the Portal

Open your browser and navigate to:
http://localhost:4321
You should see the government portal homepage with:
  • Municipal hero section
  • Access links to government services
  • Call-to-action banners
  • Government axes grid

​
Explore Key Features

Now that the platform is running, explore these key areas:

Government Portal

Main portal with institutional information

Tourism System

Interactive tourism platform (requires Supabase)

Xochitlanis

Cultural event landing page with gallery

Transparency

Government transparency and downloads

​
Available Commands

All commands are run from the root of the project:
CommandAction
npm installInstall dependencies
npm run devStart local dev server at localhost:4321
npm run buildBuild production site to ./dist/
npm run previewPreview production build locally
npm run astro ...Run Astro CLI commands
npm run test:routesBuild and run Playwright route tests

​
Next Steps

Complete Installation

Set up database, OAuth providers, and deployment

Government Portal Features

Learn about institutional pages and services

Tourism System

Understand the Xochitlanis platform and onboarding

Authentication

Configure OAuth and user management

​
Troubleshooting

If port 4321 is already in use, you can specify a different port:
npm run dev -- --port 3000
If you see module resolution errors, try:
rm -rf node_modules package-lock.json
npm install
Verify your environment variables:
  1. Check .env has correct PUBLIC_SUPABASE_URL and PUBLIC_SUPABASE_ANON_KEY
  2. Restart the dev server after changing .env
  3. Verify your Supabase project is active at app.supabase.com
The project uses TailwindCSS v4 with Vite plugin. Make sure you have:
npm install @tailwindcss/vite@^4.1.18
For production deployment, see the Installation guide for complete setup including database initialization and OAuth configuration.

Build docs developers (and LLMs) love

Get started for freeTalk to us