diff --git a/menu_example/menu_example.info.yml b/menu_example/menu_example.info.yml
new file mode 100644
index 0000000..e9f6e4e
--- /dev/null
+++ b/menu_example/menu_example.info.yml
@@ -0,0 +1,7 @@
+name: Menu Example
+type: module
+description: 'An example module showing the main steps to define and handling menu links in Drupal 8 '
+package: 'Example modules'
+core: 8.x
+dependencies:
+  - drupal:examples
diff --git a/menu_example/menu_example.links.task.yml b/menu_example/menu_example.links.task.yml
new file mode 100644
index 0000000..e4a9c3f
--- /dev/null
+++ b/menu_example/menu_example.links.task.yml
@@ -0,0 +1,37 @@
+examples.menu_example.tabdefault:
+  route_name: examples.menu_example.tabs
+  title: 'Default Primary Tab'
+  parent_id: examples.menu_example.tabs
+
+examples.menu_example.tabOne:
+  route_name: examples.menu_example.tabname
+  title: 'two'
+  parent_id: examples.menu_example.tabs
+  weight: 2
+
+examples.menu_example.tabTwo:
+  route_name: examples.menu_example.tabnameThree
+  title: 'three'
+  parent_id: examples.menu_example.tabs
+  weight: 3
+
+examples.menu_example.tabThree:
+  route_name: examples.menu_example.tabnameFour
+  title: 'four'
+  parent_id: examples.menu_example.tabs
+  weight: 4
+
+examples.menu_example.secondaryDefault:
+  route_name: examples.menu_example.default
+  title: 'Default Secondary Tab'
+  parent_id: examples.menu_example.default
+
+examples.menu_example.secondaryDefault:
+  route_name: examples.menu_example.defaultSecond
+  title: 'Second Secondary Tab'
+  parent_id: examples.menu_example.default
+
+examples.menu_example.secondaryDefault:
+  route_name: examples.menu_example.defaultThird
+  title: 'Third Secondary Tab'
+  parent_id: examples.menu_example.default
diff --git a/menu_example/menu_example.module b/menu_example/menu_example.module
new file mode 100644
index 0000000..6b639f1
--- /dev/null
+++ b/menu_example/menu_example.module
@@ -0,0 +1,6 @@
+<?php
+
+/**
+ * @file
+ * Module file for menu_example_module.
+ */
diff --git a/menu_example/menu_example.permissions.yml b/menu_example/menu_example.permissions.yml
new file mode 100644
index 0000000..4c74c2e
--- /dev/null
+++ b/menu_example/menu_example.permissions.yml
@@ -0,0 +1,7 @@
+# File contains permissions for the menu_example module.
+access protected menu example:
+  title: 'Access protected menu example'
+  description: 'Bypass access control when accessing menu example.'
+  restrict access: TRUE
+
+
diff --git a/menu_example/menu_example.routing.yml b/menu_example/menu_example.routing.yml
new file mode 100644
index 0000000..c60ca69
--- /dev/null
+++ b/menu_example/menu_example.routing.yml
@@ -0,0 +1,151 @@
+examples.menu_example:
+  path: '/examples/menu-example'
+  defaults:
+    _controller: '\Drupal\menu_example\Controller\MenuExampleController::basicInstructions'
+    _title: 'Menu Example'
+  requirements:
+    _permission: 'access content'
+
+examples.menu_example.alternate_menu:
+  path: '/examples/menu_example_alternate_menu'
+  defaults:
+    _controller: '\Drupal\menu_example\Controller\MenuExampleController::alternateMenu'
+    _title: 'Menu Example: Menu in alternate menu'
+  requirements:
+    _access: 'TRUE'
+
+examples.menu_example.permissioned:
+  path: '/examples/menu_example/permissioned'
+  defaults:
+    _controller: '\Drupal\menu_example\Controller\MenuExampleController::permissioned'
+    _title: 'Permissioned Example'
+  requirements:
+    _access: 'TRUE'
+
+examples.menu_example.permissioned_controlled:
+  path: '/examples/menu_example/permissioned/controlled'
+  defaults:
+    _controller: '\Drupal\menu_example\Controller\MenuExampleController::permissionedControlled'
+    _title: 'Permissioned Menu Item'
+  requirements:
+    _permission: 'access protected menu example'
+
+examples.menu_example.custom_access:
+  path: '/examples/menu_example/custom-access'
+  defaults:
+    _controller: '\Drupal\menu_example\Controller\MenuExampleController::customAccess'
+    _title: 'Custom Access Example'
+  requirements:
+    _permission: 'access content'
+
+examples.menu_example.path_only:
+  path: '/examples/menu_example/path-only'
+  defaults:
+    _controller: '\Drupal\menu_example\Controller\MenuExampleController::pathOnly'
+    _title: 'Menu_Callback example'
+  requirements:
+    _access: 'TRUE'
+
+examples.menu_example.tabs:
+  path: 'examples/menu_example/tabs'
+  defaults:
+    _controller: '\Drupal\menu_example\Controller\MenuExampleController::tabs'
+    _title: 'Tabs'
+  requirements:
+    _access: 'TRUE'
+
+examples.menu_example.default:
+  path: 'examples/menu_example/tabs/default'
+  deafaults:
+    _title: 'deafault primary tab'
+    requirements:
+      _access: 'TRUE'
+
+examples.menu_example.tabname:
+  path: 'examples/menu_example/tabs/second'
+  defaults:
+    _title: 'second'
+    _controller: '\Drupal\menu_example\Controller\MenuExampleController::tabNameSecond'
+  requirements:
+    _access: 'TRUE'
+
+examples.menu_example.tabnameThree:
+  path: 'examples/menu_example/tabs/third'
+  defaults:
+    _title: 'third'
+    _controller: '\Drupal\menu_example\Controller\MenuExampleController::tabNameThird'
+  requirements:
+    _access: 'TRUE'
+
+examples.menu_example.tabnameFour:
+  path: 'examples/menu_example/tabs/forth'
+  defaults:
+    _title: 'four'
+    _controller: '\Drupal\menu_example\Controller\MenuExampleController::tabNameForth'
+  requirements:
+    _access: 'TRUE'
+
+examples.menu_example.defaultSecond:
+  path: 'examples/menu_example/tabs/default/Second'
+  defaults:
+    _title: 'Second Secondary tab'
+    _controller: '\Drupal\menu_example\Controller\MenuExampleController::defaultSecond'
+  requirements:
+    _access: 'TRUE'
+
+examples.menu_example.defaultThird:
+  path: 'examples/menu_example/tabs/default/third'
+  defaults:
+    _title: 'Third secondary tab'
+    _controller: '\Drupal\menu_example\Controller\MenuExampleController::defaultThird'
+  requirements:
+    _access: 'TRUE'
+
+example.menu_example.use_url_arguments:
+  path: 'examples/menu_example/use-url-arguments'
+  defaults:
+    _title: 'Extra Agruments'
+    _controller: '\Drupal\menu_example\Controller\MenuExampleController::urlArgument'
+  requirements:
+    _access: 'TRUE'
+
+examples.menu_example.title_callbacks:
+  path: 'examples/menu_example/title-callbacks'
+  defaults:
+    _title_callback: 'Drupal\menu_example\Controller\MenuExampleController::backTitle'
+    _controller: '\Drupal\menu_example\Controller\MenuExampleController::titleCallback'
+  requirements:
+    _access: 'TRUE'
+
+examples.menu_example.placeholder_argument:
+  path: 'examples/menu_example/placeholder-argument'
+  defaults:
+    _title: 'Placeholder Arguments'
+    _controller: '\Drupal\menu_example\Controller\MenuExampleController::argument'
+  requirements:
+    _access: 'TRUE'
+
+examples.menu_example.placeholder_argument.display:
+  path: 'examples/menu_example/placeholder-argument/{node}/display'
+  defaults:
+    _title: 'Placeholder Arguments'
+    _controller: '\Drupal\menu_example\Controller\MenuExampleController::display'
+  requirements:
+     _access: 'TRUE'
+
+examples.menu_example.default_arg.arg_optional:
+  path: 'examples/menu_example/default-arg/{no}'
+  defaults:
+    _title: 'Processed Placeholder Arguments'
+    _controller: '\Drupal\menu_example\Controller\MenuExampleController::argOptional'
+     upcast: ''
+  requirements:
+    _access: 'TRUE'
+
+example.menu_example.menu_original_path:
+  path: 'examples/menu_example/menu_original_path'
+  defaults:
+    _title: 'Menu path that will be altered by hook_menu_alter()'
+    _controller: '\Drupal\menu_example\Controller\MenuExampleController::orginalPath'
+  requirements:
+    _access: 'TRUE'
diff --git a/menu_example/src/Controller/MenuExampleController.php b/menu_example/src/Controller/MenuExampleController.php
new file mode 100644
index 0000000..cbd6740
--- /dev/null
+++ b/menu_example/src/Controller/MenuExampleController.php
@@ -0,0 +1,232 @@
+<?php
+
+namespace Drupal\menu_example\Controller;
+
+use Drupal\Core\Controller\ControllerBase;
+use Drupal\Core\Link;
+use Drupal\Core\Url;
+
+/**
+ * Controller routines for menu example routes.
+ */
+class MenuExampleController extends ControllerBase {
+
+  /**
+   * Page callback for the simplest introduction menu entry.
+   * The router _controller callback, maps the path
+   * 'examples/menu-example' to this method.
+   */
+  public function basicInstructions() {
+    $url = Url::fromUri('internal:/examples/menu-example/path-only');
+    $link = Link::fromTextAndUrl($this->t('visit a similar page with no menu link'), $url)->toString();
+    return [
+      '#markup' => $this->t('This page is displayed by the simplest (and base)
+       menu example. Note that the title of the page is the same as the link
+       title. You can also @link. There are a number of
+       examples here, from the most basic (like this one) to extravagant
+        mappings of loaded placeholder arguments. Enjoy!', ['@link' => $link]),
+    ];
+  }
+
+  /**
+   *
+   */
+  public function alternateMenu() {
+    return [
+      '#markup' => t('This will be in the Main menu instead of the default Tools menu'),
+    ];
+
+  }
+
+  /**
+   *
+   */
+  public function permissioned() {
+    $url = Url::fromUri('internal:/examples/menu_example/permissioned/controlled');
+    $link = Link::fromTextAndUrl($this->t('examples/menu_example/permissioned/controlled'), $url)->toString();
+    return [
+      '#markup' => $this->t('A menu item that requires the "access protected menu example" permission is at @link', ['@link' => $link]),
+    ];
+  }
+
+  /**
+   *
+   */
+  public function permissionedControlled() {
+    return [
+      '#markup' => $this->t('This menu entry will not show and the page will not be accessible without the "access protected menu example" permission.'),
+    ];
+  }
+
+  /**
+   *
+   */
+  public function customAccess() {
+    $url = Url::fromUri('internal:/examples/menu_example/custom-access/page');
+    $link = Link::fromTextAndUrl($this->t('examples/menu_example/custom-access/page'), $url)->toString();
+    return [
+      '#markup' => $this->t('A menu item that requires the user to posess a role of "authenticated" is at @link', ['@link' => $link]),
+    ];
+  }
+
+  /**
+   *
+   */
+  public function pathonly() {
+    $url = Url::fromUri('internal:/examples/menu_example/path-only/callback');
+    $link = Link::fromTextAndUrl($this->t('examples/menu_example/path-only/callback'), $url)->toString();
+    return [
+      '#markup' => $this->t('A menu entry with no menu link (MENU_CALLBACK) is at @link', ['@link' => $link]),
+    ];
+  }
+
+  /**
+   *
+   */
+  public function tabs() {
+    return [
+      '#markup' => $this->t('This is the "tabs" menu entry.'),
+    ];
+  }
+
+  /**
+   *
+   */
+  public function tabNameSecond() {
+    return [
+      '#markup' => $this->t('This is the tab "Second" in the "basic tabs" example'),
+    ];
+  }
+
+  /**
+   *
+   */
+  public function tabNameThird() {
+    return [
+      '#markup' => $this->t('This is the tab "Thrid" in the "basic tabs" example'),
+    ];
+  }
+
+  /**
+   *
+   */
+  public function tabNameForth() {
+    return [
+      '#markup' => $this->t('This is the tab "Forth" in the "basic tabs" example'),
+    ];
+  }
+
+  /**
+   *
+   */
+  public function defaultSecond() {
+    return [
+      '#markup' => $this->t('This is the secondary tab second in the "basic tabs" example "default"tab'),
+    ];
+  }
+
+  /**
+   *
+   */
+  public function defaultThird() {
+    return [
+      '#markup' => $this->t('This is the secondary tab Third in the "basic tabs" example "default"tab'),
+    ];
+  }
+
+  /**
+   *
+   */
+  public function urlArgument() {
+    $url = Url::fromUri('internal:/examples/menu_example/use-url-arguments/firstarg/secondarg');
+    $link = Link::fromTextAndUrl($this->t('examples/menu_example/use-url-arguments/firstarg/secondarg'), $url)->toString();
+    $urle = Url::fromUri('internal:/examples/menu_example/use-url-arguments/one/two');
+    $linker = Link::fromTextAndUrl($this->t('examples/menu_example/use-url-arguments/one/two'), $urle)->toString();
+    return [
+      '#markup' => $this->t('This page demonstrates using arguments in the path (portions of the path after "menu_example/use-url-arguments". For example, access it with @link or @linker', ['@link' => $link], ['@linker' => $linker]),
+
+    ];
+  }
+
+  /**
+   *
+   */
+  public function titleCallback() {
+    return [
+      '#markup' => $this->t('The title of this page is dynamically changed by the title callback for this route.'),
+    ];
+  }
+
+  /**
+   *
+   */
+  public function backTitle($title = '') {
+    // Pass your uid.
+    $title = \Drupal::currentUser()->id();
+    // $title = $account->getUsername()->toString();
+    // $account = \Drupal::currentUser()->id();
+    // $title=$account->get('name')->value;
+    return [
+      '#markup' => $this->t('@title', ['@title' => $title]),
+    ];
+  }
+
+  /**
+   *
+   */
+  public function argument() {
+    $url = Url::fromUri('internal:/examples/menu_example/placeholder-argument/3343/display');
+    $link = Link::fromTextAndUrl($this->t('examples/menu_example/placeholder-argument/3343/display'), $url)->toString();
+    return [
+      '#markup' => $this->t('Demonstrate placeholders by visiting @link', ['@link' => $link]),
+    ];
+  }
+
+  /**
+   *
+   */
+  public function display($node = '') {
+    return [
+      '#markup' => $node,
+    ];
+
+  }
+
+  /**
+   *
+
+  public function argOptional($no = '') {
+    if (empty($no) || $arg == '%') ? 99 : $arg;
+    $mapped_value = NULL;
+    static $mappings = [
+      1 => 'one',
+      2 => 'two',
+      3 => 'three',
+      99 => 'jackpot! default',
+    ];
+    if (isset($mappings[$id])) {
+      $mapped_value = $mappings[$no];
+    }
+    $mapped_value = _menu_example_mappings($no);
+    if (!empty($mapped_value)) {
+      return [
+        '#markup' => $this->t('Loaded value was @loaded', ['@loaded' => $mapped_value]),
+      ];
+    }
+    else {
+      return [
+        '#markup' => $this->t('Sorry, the id @id was not found to be loaded', ['@id' => $no]),
+      ];
+    }
+
+  }*/
+
+  /**
+   *
+   */
+  public function orginalPath() {
+    return [
+      '#markup' => t('This menu item was created strictly to allow the hook_menu_alter() function to have something to operate on.hook_menu defined the path as examples/menu_example/menu_original_path. The hook_menu_alter() changes it to examples/menu_example/menu_altered_path. You can try navigating to both paths and see what happens!'
+    ];
+  }
+}