feat(i18n): Add Spanish language support

[NeftaliYagua]

Summary

This pull request adds complete Spanish (es) language support to the Socket.IO documentation website.

Changes Made

Configuration

• Updated docusaurus.config.js to include es in the list of supported locales

Translation Files Added

The following translation files have been added under i18n/es/:

Core Configuration Files

• code.json - UI strings and labels
• docusaurus-theme-classic/navbar.json - Navigation bar translations
• docusaurus-theme-classic/footer.json - Footer translations
• docusaurus-plugin-content-blog/options.json - Blog plugin translations
• docusaurus-plugin-content-docs/current.json - Docs plugin translations
• docusaurus-plugin-content-docs/version-2.x.json - Version 2.x labels
• docusaurus-plugin-content-docs/version-3.x.json - Version 3.x labels

Documentation Categories (86 markdown files)

• 01-Documentation: Core documentation including how-it-works, troubleshooting, TypeScript support, testing, logging, memory usage, delivery guarantees, and connection state recovery
• 02-Server: Server-side documentation including initialization, installation, middlewares, CORS handling, reverse proxy setup, bundlers, multiple nodes, and socket instances
• 03-Client: Client-side documentation including initialization, installation, offline behavior, bundlers, and socket instances
• 04-Events: Event handling documentation including emitting, listening, broadcasting, and rooms
• 05-Adapters: All adapter documentation (Redis, Redis Streams, MongoDB, PostgreSQL, Cluster, AWS SQS, Azure Service Bus, GCP Pub/Sub)
• 06-Advanced: Advanced topics including Admin UI, custom parsers, load testing, namespaces, performance tuning, and PM2 usage
• 07-Migrations: Migration guides from v2 to v3 and v3 to v4
• 08-Miscellaneous: FAQ, glossary, and protocol specifications (Engine.IO and Socket.IO)

API Reference

• server-api.md - Complete Server API reference
• client-api.md - Complete Client API reference
• server-options.md - Server configuration options
• client-options.md - Client configuration options
• emit-cheatsheet.md - Emit cheatsheet

Tutorial (13 chapters)

Complete translation of the step-by-step tutorial:

1. Introduction
2. Project initialization
3. Serving HTML
4. Integrating Socket.IO
5. Emitting events
6. Broadcasting
7. API overview
8. Handling disconnections
9. Connection state recovery
10. Server delivery
11. Client delivery
12. Scaling horizontally
13. Ending notes

Changelog

All changelog entries from version 2.5.0 through 4.8.1

Additional Pages

• socket-io-with-apache-cordova.md - Apache Cordova integration guide

Why This Matters

Spanish is one of the most spoken languages in the world, with over 500 million native speakers. Adding Spanish language support will:

1. Expand accessibility - Make Socket.IO documentation accessible to Spanish-speaking developers worldwide
2. Lower the barrier to entry - Help developers who are more comfortable reading technical documentation in their native language
3. Grow the community - Attract more contributors and users from Spanish-speaking countries in Latin America and Spain

Testing

• ✅ Successfully builds with npm run build
• ✅ All locale files follow the existing structure used by other languages (fr, pt-br, zh-CN)
• ✅ No breaking changes to existing functionality

Related

This follows the same structure and conventions established by the existing translations:

• French (fr)
• Portuguese - Brazil (pt-br)
• Chinese - Simplified (zh-CN)

---

I would be happy to address any feedback or make adjustments as needed. Thank you for considering this contribution! 🙏

[vercel]

@NeftaliYagua is attempting to deploy a commit to the SocketIO Team on Vercel.

A member of the Team first needs to authorize it.

[NeftaliYagua]

Hello!

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Review	Updated (UTC)
socket-io-website	Ready	Preview, Comment	Dec 17, 2025 5:08pm

[darrachequesne]

Awesome, thanks a lot for the hard work 👍