Tools Component

Overview

The Tools.astro component displays a categorized grid of technologies and tools. It features an interactive modal powered by Alpine.js that shows certificates and projects related to each tool. Tools are organized by category (Frontend, Backend, Database, Frameworks) and fetched from Supabase.

Location

src/components/Tools.astro

Key Features

Multi-table Supabase queries for tools, certificates, and projects
Alpine.js modal for interactive tool details
Horizontal scrollable tool grids per category
Visual indicators (pulsing dot) for tools with related content
Related content display (certificates and projects)

Supabase Integration

1. Fetch Tools by Category

async function fetchToolsByType(type: string) {
  const { data, error } = await supabase
    .from("tools")
    .select("*")
    .eq("type", type)
    .eq("visible", true)
    .order("name");

  if (error) console.error(`Error fetching ${type} tools:`, error);
  return data || [];
}

2. Fetch Tool Certificates

async function fetchToolCertificates(toolId: number) {
  const { data, error } = await supabase
    .from("certificate_tool")
    .select(`
      certificate_id,
      certificates:certificate_id (
        id, title, issuer, type, date, certificate_url, visible
      )
    `)
    .eq("tool_id", toolId)
    .filter("certificates.visible", "eq", true);

  if (error) console.error(`Error fetching certificates for tool ${toolId}:`, error);
  return data?.map(item => item.certificates).filter(Boolean) || [];
}

3. Fetch Tool Projects

async function fetchToolProjects(toolId: number) {
  const { data, error } = await supabase
    .from("project_tool")
    .select(`
      project_id,
      projects:project_id (
        id, title, description, codeLink, PreviewLink, image, visible
      )
    `)
    .eq("tool_id", toolId)
    .filter("projects.visible", "eq", true);

  if (error) console.error(`Error fetching projects for tool ${toolId}:`, error);
  return data?.map(item => item.projects).filter(Boolean) || [];
}

Database Schema

tools Table

number

required

Primary key

name

string

required

Tool/technology name

type

string

required

Category: Frontend, Backend, Database, Framework

icon

string

URL to tool icon/logo

visible

boolean

default:true

Whether to display this tool

certificates Table

number

required

Primary key

title

string

required

Certificate name

issuer

string

required

Issuing organization

type

string

Certificate type/category

date

required

Issue date

certificate_url

string

required

URL to certificate

visible

boolean

default:true

Whether to display this certificate

Junction Tables

certificate_tool: Links certificates to tools

certificate_id (references certificates.id)
tool_id (references tools.id)

project_tool: Links projects to tools (see Projects component)

project_id (references projects.id)
tool_id (references tools.id)

Alpine.js State Management

x-data="{
  selectedTool: null,
  modalOpen: false,
  openModal(tool) {
    this.selectedTool = tool;
    this.modalOpen = true;
  },
  closeModal() {
    this.modalOpen = false;
    setTimeout(() => this.selectedTool = null, 300);
  }
}"

Code Structure

Categories Setup

const categories = [
  { type: "Frontend", title: "Frontend" },
  { type: "Backend", title: "Backend" },
  { type: "Database", title: "Database" },
  { type: "Framework", title: "Frameworks" }
];

const results = await Promise.all(
  categories.map(c => fetchToolsByType(c.type))
);

const sections = categories.map((c, i) => ({
  ...c,
  tools: results[i]
}));

Tool Card with Click Handler

<div 
  class={`flex flex-col items-center space-y-3 min-w-[65px] ${
    tool.hasRelatedContent ? 'cursor-pointer transition hover:scale-110' : ''
  }`}
  x-on:click={tool.hasRelatedContent ? `openModal(${JSON.stringify(tool)})` : null}
>
  <div class="w-16 h-16 flex items-center justify-center relative">
    {tool.icon ? (
      <img src={tool.icon} alt={`${tool.name} icon`} class="w-12 h-12" />
    ) : (
      <svg viewBox="0 0 24 24" class="w-12 h-12">
        <path fill="currentColor" d="M12 2L2 7l10 5 10-5-10-5zM2 17l10 5 10-5M2 12l10 5 10-5" />
      </svg>
    )}
    {tool.hasRelatedContent && (
      <span class="absolute -top-5 -right-0 w-2 h-2 bg-[#fdc700] rounded-full shadow animate-pulse"></span>
    )}
  </div>
  <h3 class="text-gray-600 dark:text-gray-300">{tool.name}</h3>
</div>

<div 
  x-show="modalOpen" 
  class="fixed inset-0 z-50 overflow-y-auto flex items-center justify-center p-4 bg-black/20 backdrop-blur-sm"
  x-cloak
>
  <div 
    x-show="modalOpen" 
    @click.away="closeModal()"
    class="w-full max-w-2xl max-h-[85vh] overflow-y-auto bg-white dark:bg-gray-800 rounded-lg shadow-xl"
  >
    <!-- Modal header -->
    <div class="flex items-center justify-between p-4 md:p-5 border-b">
      <h3 class="text-xl font-semibold flex items-center gap-3">
        <img x-bind:src="selectedTool?.icon" x-bind:alt="selectedTool?.name" class="w-8 h-8" />
        <span x-text="selectedTool?.name"></span>
      </h3>
      <button type="button" @click="closeModal()">
        <!-- Close icon -->
      </button>
    </div>

    <!-- Modal body -->
    <div class="p-4 md:p-5 space-y-4">
      <!-- Certificates section -->
      <template x-if="selectedTool?.certificates?.length > 0">
        <!-- Certificate cards -->
      </template>

      <!-- Projects section -->
      <template x-if="selectedTool?.projects?.length > 0">
        <!-- Project cards -->
      </template>

      <!-- Empty state -->
      <template x-if="!selectedTool?.certificates?.length && !selectedTool?.projects?.length">
        <p>No hay certificados ni proyectos relacionados...</p>
      </template>
    </div>
  </div>
</div>

Visual Features

Horizontal Scroll

<div class="flex overflow-x-auto snap-x scroll-smooth scroll-pl-6 gap-8 pb-4 custom-scrollbar">
  <!-- Tool items -->
</div>

Custom scrollbar styles:

.custom-scrollbar {
  scrollbar-width: thin;
  scrollbar-color: rgba(156, 163, 175, 0.5) rgba(243, 244, 246, 0.1);
}

.custom-scrollbar::-webkit-scrollbar {
  height: 6px;
}

.custom-scrollbar::-webkit-scrollbar-thumb {
  background-color: rgba(156, 163, 175, 0.5);
  border-radius: 8px;
}

Pulsing Indicator

{tool.hasRelatedContent && (
  <span class="absolute -top-5 -right-0 w-2 h-2 bg-[#fdc700] rounded-full shadow animate-pulse"></span>
)}

x-transition:enter="transition ease-out duration-300"
x-transition:enter-start="opacity-0 transform scale-95"
x-transition:enter-end="opacity-100 transform scale-100"
x-transition:leave="transition ease-in duration-200"
x-transition:leave-start="opacity-100 transform scale-100"
x-transition:leave-end="opacity-0 transform scale-95"

Usage Example

---
import Layout from '../layouts/Layout.astro';
import SectionContainer from '../components/SectionContainer.astro';
import TitleSection from '../components/TitleSection.astro';
import Tools from '../components/Tools.astro';
---

<Layout title="My Tools">
  <SectionContainer id="herramientas">
    <TitleSection>
      <svg slot="icon"><!-- Tools icon --></svg>
      Technologies & Tools
    </TitleSection>
    <Tools />
  </SectionContainer>
</Layout>

Database Setup

Create Tables

-- Tools table
CREATE TABLE tools (
  id SERIAL PRIMARY KEY,
  name VARCHAR(100) NOT NULL,
  type VARCHAR(50) NOT NULL,
  icon TEXT,
  visible BOOLEAN DEFAULT true
);

-- Certificates table
CREATE TABLE certificates (
  id SERIAL PRIMARY KEY,
  title VARCHAR(255) NOT NULL,
  issuer VARCHAR(255) NOT NULL,
  type VARCHAR(100),
  date DATE NOT NULL,
  certificate_url TEXT NOT NULL,
  visible BOOLEAN DEFAULT true
);

-- Certificate-Tool junction
CREATE TABLE certificate_tool (
  certificate_id INTEGER REFERENCES certificates(id) ON DELETE CASCADE,
  tool_id INTEGER REFERENCES tools(id) ON DELETE CASCADE,
  PRIMARY KEY (certificate_id, tool_id)
);

Insert Sample Data

-- Insert tools
INSERT INTO tools (name, type, icon) VALUES
('React', 'Frontend', 'https://cdn.jsdelivr.net/gh/devicons/devicon/icons/react/react-original.svg'),
('PostgreSQL', 'Database', 'https://cdn.jsdelivr.net/gh/devicons/devicon/icons/postgresql/postgresql-original.svg');

-- Insert certificate
INSERT INTO certificates (title, issuer, type, date, certificate_url) VALUES
('React Advanced Patterns', 'Frontend Masters', 'Course', '2024-01-15', 'https://example.com/cert.pdf');

-- Link certificate to tool
INSERT INTO certificate_tool (certificate_id, tool_id) VALUES (1, 1);

Customization Tips

Add New Categories

const categories = [
  { type: "Frontend", title: "Frontend" },
  { type: "Backend", title: "Backend" },
  { type: "Database", title: "Database" },
  { type: "Framework", title: "Frameworks" },
  { type: "DevOps", title: "DevOps" }, // New category
  { type: "Design", title: "Design Tools" } // New category
];

Change Grid Layout

<div class="grid grid-cols-2 md:grid-cols-3 gap-8 mt-15"> <!-- Changed from grid-cols-1 md:grid-cols-2 -->

<div 
  class="flex flex-col items-center space-y-3 min-w-[65px]"
  <!-- Remove x-on:click -->
>

Change Indicator Color

<span class="... bg-blue-500"></span> <!-- Changed from bg-[#fdc700] -->

<div class="w-full max-w-4xl..."> <!-- Changed from max-w-2xl -->

Add Tool Descriptions

Extend database:

ALTER TABLE tools ADD COLUMN description TEXT;

Display in modal:

<div class="p-4 md:p-5 space-y-4">
  <p class="text-gray-600 dark:text-gray-300" x-text="selectedTool?.description"></p>
  <!-- Rest of modal content -->
</div>

Performance Considerations

Uses Promise.all to fetch tools in parallel
Related content (certificates/projects) fetched for all tools upfront
Alpine.js is lightweight (~15kb)
Images use proper sizing attributes

Accessibility Features

Semantic HTML structure
Close button with proper aria labels
Modal click-outside-to-close
Keyboard navigation support (Alpine.js built-in)
High contrast colors
Focus management

Alpine.js Features Used

x-data: Component state
x-show: Conditional rendering
x-on:click: Event handling
x-bind: Dynamic attributes
x-text: Text content binding
x-if: Conditional templates
x-for: List rendering
x-transition: Animations
x-cloak: Hide uninitialized content
@click.away: Click outside handler

Dark Mode Support

Full dark mode with:

Modal background colors
Text color adjustments
Border colors
Card hover states
Link colors

Browser Compatibility

Requires:

Modern browser with CSS Grid support
JavaScript enabled (for Alpine.js)
CSS custom scrollbar support (graceful degradation)

Getting Started

Components

Configuration

Deployment

Customization

Overview

Location

Key Features

Supabase Integration

1. Fetch Tools by Category

2. Fetch Tool Certificates

3. Fetch Tool Projects

Database Schema

tools Table

certificates Table

Junction Tables

Alpine.js State Management

Code Structure

Categories Setup

Tool Card with Click Handler

Visual Features

Horizontal Scroll

Pulsing Indicator

Usage Example

Database Setup

Create Tables

Insert Sample Data

Customization Tips

Add New Categories

Change Grid Layout

Change Indicator Color

Add Tool Descriptions

Performance Considerations

Accessibility Features

Alpine.js Features Used

Dark Mode Support

Browser Compatibility

Build docs developers (and LLMs) love

Getting Started

Components

Configuration

Deployment

Customization

Documentation Index

​Overview

​Location

​Key Features

​Supabase Integration

​1. Fetch Tools by Category

​2. Fetch Tool Certificates

​3. Fetch Tool Projects

​Database Schema

​tools Table

​certificates Table

​Junction Tables

​Alpine.js State Management

​Code Structure

​Categories Setup

​Tool Card with Click Handler

​Modal Structure

​Visual Features

​Horizontal Scroll

​Pulsing Indicator

​Modal Transitions

​Usage Example

​Database Setup

​Create Tables

​Insert Sample Data

​Customization Tips

​Add New Categories

​Change Grid Layout

​Disable Modal for All Tools

​Change Indicator Color

​Modify Modal Size

​Add Tool Descriptions

​Performance Considerations

​Accessibility Features

​Alpine.js Features Used

​Dark Mode Support

​Browser Compatibility

Build docs developers (and LLMs) love

Overview

Location

Key Features

Supabase Integration

1. Fetch Tools by Category

2. Fetch Tool Certificates

3. Fetch Tool Projects

Database Schema

tools Table

certificates Table

Junction Tables

Alpine.js State Management

Code Structure

Categories Setup

Tool Card with Click Handler

Modal Structure

Visual Features

Horizontal Scroll

Pulsing Indicator

Modal Transitions

Usage Example

Database Setup

Create Tables

Insert Sample Data

Customization Tips

Add New Categories

Change Grid Layout

Disable Modal for All Tools

Change Indicator Color

Modify Modal Size

Add Tool Descriptions

Performance Considerations

Accessibility Features

Alpine.js Features Used

Dark Mode Support

Browser Compatibility