diff --git a/README.md b/README.md
index c69dd39..dc5496c 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,30 @@
-# bus-tracking
\ No newline at end of file
+# bus-tracking
+<img src="map-bus-tracking.gif">
+
+## Descripción
+<hr />
+En este proyecto se pone en practica el consumo de apis para mostrar información de la posición de autobuses en un mapa 
+de la zona de Boston
+
+## Prerequisitos
+<hr />
+Contar con una cuenta en MapBox de modo que se pueda obtener un APIKEY, misma que se debe ingresar en el formulario
+para poder mostrar el mapa.
+
+## Ejecución
+<hr />
+<ol>
+<li>Descargar los archivos:
+    <ol>
+    <li>Entrar a la pestaña Code</li>
+    <li>Dar clic en el botón <>Code</li>
+    <li>Esto abrirá una pequeña ventana donde se debe seleccionar la opción Download ZIP</li>
+    </ol>
+</li>
+<li>Descomprimir el directorio descargado</li>
+<li>ingresar a la carepta principal</li>
+<li>Abrir el archivo index.html en el navegador web de su preferencia</li>
+<li>Ingresar API KEY en el área de texto</li>
+<li>Dar clic en el botón [2 Cargar Mapa], esto mostrará el mapa de la zona de Boston en caso de haber ingresado una APIKEY válida</li>
+<li>Dar clic en el botón [3 Mostrar Marcadores], esto mostrará los marcadores de los autobuses en el mapa previamente cargado</li>
+</ol>
\ No newline at end of file
diff --git a/map-bus-tracking.gif b/map-bus-tracking.gif
new file mode 100644
index 0000000..b595388
Binary files /dev/null and b/map-bus-tracking.gif differ