Una estructura clara y coherente en un proyecto web es la base de un desarrollo profesional. Organizar correctamente carpetas y archivos facilita el mantenimiento, reduce errores y mejora el trabajo en equipo.
📌 Piensa en tu proyecto como una caja de herramientas ordenada: si cada cosa está en su sitio, trabajar será más rápido, seguro y escalable.
Estructura básica recomendada
mi_proyecto/
├── index.html (o index.php)
├── css/
│ └── styles.css
├── js/
│ └── scripts.js
├── img/
│ └── logo.png
├── php/ (opcional)
│ └── funciones.php
├── vendor/ (dependencias externas)
├── .gitignore
└── README.md
Función de cada carpeta o archivo
| Elemento | Función principal |
|---|---|
| index.html/php | Página principal del sitio. |
| css/ | Contiene las hojas de estilo. |
| js/ | Scripts de JavaScript. |
| img/ | Imágenes, iconos y recursos gráficos. |
| php/ | Lógica del servidor (cuando se usa PHP). |
| vendor/ | Librerías externas (ejemplo: Bootstrap, Composer). |
| .gitignore | Archivos o carpetas que Git debe ignorar. |
| README.md | Explicación del proyecto e instrucciones de uso. |
Buenas prácticas de nombres y estructura
- Usa nombres claros, en minúsculas y sin espacios:
✅formulario_contacto.php
❌Formulario Contacto.php - Separa el contenido por tipo: HTML/PHP, CSS, JS, imágenes.
- Elimina duplicados y archivos de prueba innecesarios.
- Incluye siempre un README.md, aunque trabajes en solitario.
- Documenta cómo funciona el proyecto y qué contiene cada carpeta.
Estructura y control de versiones (Git)
- Usa
.gitignorepara excluir carpetas y archivos que no deben subirse:
node_modules/
vendor/
.env
*.log
- Sube la estructura al repositorio desde el inicio, aunque esté vacía.
- Haz commits descriptivos cada vez que cambies la estructura:
git commit -m "Añadida estructura base del proyecto"
Crear la estructura desde terminal (opcional)
mkdir mi_proyecto && cd mi_proyecto
mkdir css js img php
touch index.html css/styles.css js/scripts.js php/funciones.php README.md .gitignore
📌 Si usas Visual Studio Code, abre todo con:
code .
¿Qué ocurre si no organizas bien tu proyecto?
- Código desordenado y difícil de leer.
- Archivos duplicados sin control.
- Problemas para escalar o depurar.
- Riesgo de romper funcionalidades.
- Pérdida de tiempo buscando archivos.
Conclusiones de la lección
- Una estructura clara te permite desarrollar con orden y lógica.
- Cada carpeta y archivo debe tener un propósito definido.
- Documenta tu estructura con un README.md desde el inicio.
- Usa Git para versionar tu proyecto y mantener el control.
- No importa el tamaño: incluso en proyectos pequeños, el orden es esencial.
