# akveo/blur-admin architecture

> Architecture diagram of the GitHub repository akveo/blur-admin, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-07-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/akveo/blur-admin
- Repository: https://github.com/akveo/blur-admin

## Overview

1. This repository is a front-end admin template built on AngularJS 1.x with Bootstrap, Sass, jQuery, and a Gulp-based build pipeline. Its main output is a browser-loaded SPA-style admin UI, not a backend service.

2. The application code lives under `src/app` and is split into two major layers: `pages` for feature screens and `theme` for reusable layout/UI infrastructure. That separation is the key architectural boundary in the repo.

3. `src/app/pages` contains the actual admin sections: dashboard, charts, forms, maps, tables, UI widgets, profile, mail, and components like timeline/tree. Each area is grouped as its own module and view set, which makes the feature boundaries clear for routing and lazy-ish organization within the Angular app.

4. `src/app/theme` provides the shared shell and cross-cutting UI behavior. It includes layout components such as sidebar, top bar, content header, widgets container, back-to-top, modal helpers, wizard, and message center, plus common directives, filters, services, and configuration. This layer is what gives the app its admin-panel chrome and reusable interaction patterns.

5. The theme layer also contains custom UI plumbing: directives for file input, focus, scroll tracking, width tracking, auto-expand, animations, and slider integration; services for utilities, file reading, intervals, progress modals, and preloading; and filters for image/text formatting. These are shared dependencies used across multiple page modules.

6. Feature pages are mostly view/controller pairs with some directive-based subcomponents. For example, dashboard widgets are broken into smaller self-contained pieces like weather, traffic chart, todo, map, calendar, and pie/line chart blocks, which are then composed into the dashboard page.

7. Charting and map integrations are first-class subsystems. Charts are grouped by library under `pages/charts` with amCharts, Chart.js, Chartist, and Morris variants; maps are grouped under `pages/maps` with Google Maps, Leaflet, bubbles, and line overlays. These are integration-heavy areas where external visualization libraries are wrapped in Angular modules and directives.

8. Forms and controls are organized as a dedicated subsystem under `pages/form`, with inputs, layouts, and wizard flows. It includes specialized widgets like date pickers, select pickers, switches, tags input, and validation examples, which shows the project is as much a UI component showcase as an application shell.

9. Styling is centralized in `src/sass`, with shared theme variables/mixins, component SCSS, page-specific SCSS, color-scheme variants, and Bootstrap overrides. The “blur” and “mint” theme variants are implemented primarily through Sass structure and configuration rather than separate app codebases.

10. Static assets live in `src/assets` and are treated as part of the UI bundle: fonts, icons, images, skin thumbnails, profile/todo/feed artwork, and theme icons. These assets support the visual identity of the demo/admin shell.

11. The root `src/index.html`, plus `src/auth.html`, `src/reg.html`, and `src/404.html`, indicate multiple top-level entry pages beyond the main app. The auth and registration pages are separate from the authenticated dashboard shell, while the 404 page is a standalone fallback view.

12. Build and release are managed through Gulp tasks in the `gulp` directory, with scripts for styles, scripts, images, injection, server, docs, marketplace, and build/release flows. This means the architecture includes a pre-processing pipeline that compiles Sass, bundles Angular code, and assembles distributable assets.

13. The `docs` folder is a separate documentation site with its own package and templates, not part of the runtime app. It contains tutorial articles and generated documentation assets, so the repo supports both the product UI and a companion docs portal.

14. Overall, the runtime architecture is a client-side admin shell: Angular modules route to page modules, page modules consume shared theme services/components, and all of it is packaged by Gulp from `src` plus Sass/assets into the final browser deliverable.

Main entry points: [`src/app/pages/pages.module.js`](https://github.com/akveo/blur-admin/blob/master/src/app/pages/pages.module.js) (Pages layer), [`src/app/theme/theme.module.js`](https://github.com/akveo/blur-admin/blob/master/src/app/theme/theme.module.js) (Theme layer), [`gulpfile.js`](https://github.com/akveo/blur-admin/blob/master/gulpfile.js) (Gulp build), [`src/app/app.js`](https://github.com/akveo/blur-admin/blob/master/src/app/app.js) (App bootstrap)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime app"]
  node_src_index["Main entry<br/>html entry<br/>[index.html]"]
  node_src_auth["Auth page<br/>html entry<br/>[auth.html]"]
  node_src_reg["Register page<br/>html entry<br/>[reg.html]"]
  node_src_404["Fallback page<br/>html entry<br/>[404.html]"]
  node_app_root["App bootstrap<br/>angular root<br/>[app.js]"]
  node_pages_module["Pages layer<br/>angular feature shell<br/>[pages.module.js]"]
  node_theme_module["Theme layer<br/>shared UI shell<br/>[theme.module.js]"]
  node_dashboard_page["Dashboard<br/>feature module"]
  node_charts_page["Charts<br/>feature module<br/>[charts.module.js]"]
  node_maps_page["Maps<br/>feature module<br/>[maps.module.js]"]
  node_forms_page["Forms<br/>feature module<br/>[form.module.js]"]
  node_ui_page["UI kit<br/>feature module<br/>[ui.module.js]"]
  node_tables_page["Tables<br/>feature module<br/>[tables.module.js]"]
  node_profile_page["Profile<br/>feature module<br/>[profile.module.js]"]
  node_components_page["Components<br/>feature module"]
  node_theme_components["Theme components<br/>shared components"]
  node_theme_plumbing["Theme plumbing<br/>directives/services<br/>[theme.service.js]"]
  node_dashboard_widgets{{"Dashboard widgets<br/>dashboard subcomponents"}}
  node_chart_integrations{{"Chart adapters<br/>visualization adapters"}}
  node_map_integrations{{"Map adapters<br/>map wrappers"}}
  node_form_widgets{{"Form widgets<br/>input controls"}}
  node_src_assets["UI assets<br/>static assets"]
end

subgraph group_styling["Styling"]
  node_src_sass["Sass system<br/>style architecture"]
end

subgraph group_tooling["Tooling"]
  node_gulp_pipeline["Gulp build<br/>build pipeline<br/>[gulpfile.js]"]
  node_docs_site["Docs site<br/>documentation site"]
end

node_src_index -->|"loads"| node_app_root
node_app_root -->|"routes to"| node_pages_module
node_app_root -->|"uses"| node_theme_module
node_pages_module -->|"includes"| node_dashboard_page
node_pages_module -->|"includes"| node_charts_page
node_pages_module -->|"includes"| node_maps_page
node_pages_module -->|"includes"| node_forms_page
node_pages_module -->|"includes"| node_ui_page
node_pages_module -->|"includes"| node_tables_page
node_pages_module -->|"includes"| node_profile_page
node_pages_module -->|"includes"| node_components_page
node_dashboard_page -->|"composes"| node_dashboard_widgets
node_charts_page -->|"wraps"| node_chart_integrations
node_maps_page -->|"wraps"| node_map_integrations
node_forms_page -->|"contains"| node_form_widgets
node_theme_module -->|"provides"| node_theme_components
node_theme_module -->|"provides"| node_theme_plumbing
node_theme_module -->|"consumes"| node_src_assets
node_src_sass -->|"styles"| node_theme_module
node_src_sass -->|"styles"| node_pages_module
node_gulp_pipeline -->|"builds"| node_src_sass
node_gulp_pipeline -->|"bundles"| node_app_root
node_gulp_pipeline -->|"packages"| node_src_assets
node_gulp_pipeline -.->|"generates"| node_docs_site
node_src_auth -->|"shares"| node_theme_module
node_src_reg -->|"shares"| node_theme_module
node_src_404 -->|"styled by"| node_src_sass

click node_src_index "https://github.com/akveo/blur-admin/blob/master/src/index.html"
click node_src_auth "https://github.com/akveo/blur-admin/blob/master/src/auth.html"
click node_src_reg "https://github.com/akveo/blur-admin/blob/master/src/reg.html"
click node_src_404 "https://github.com/akveo/blur-admin/blob/master/src/404.html"
click node_app_root "https://github.com/akveo/blur-admin/blob/master/src/app/app.js"
click node_pages_module "https://github.com/akveo/blur-admin/blob/master/src/app/pages/pages.module.js"
click node_theme_module "https://github.com/akveo/blur-admin/blob/master/src/app/theme/theme.module.js"
click node_dashboard_page "https://github.com/akveo/blur-admin/blob/master/src/app/pages/dashboard/dashboard.module.js"
click node_charts_page "https://github.com/akveo/blur-admin/blob/master/src/app/pages/charts/charts.module.js"
click node_maps_page "https://github.com/akveo/blur-admin/blob/master/src/app/pages/maps/maps.module.js"
click node_forms_page "https://github.com/akveo/blur-admin/blob/master/src/app/pages/form/form.module.js"
click node_ui_page "https://github.com/akveo/blur-admin/blob/master/src/app/pages/ui/ui.module.js"
click node_tables_page "https://github.com/akveo/blur-admin/blob/master/src/app/pages/tables/tables.module.js"
click node_profile_page "https://github.com/akveo/blur-admin/blob/master/src/app/pages/profile/profile.module.js"
click node_components_page "https://github.com/akveo/blur-admin/blob/master/src/app/pages/components/components.module.js"
click node_theme_components "https://github.com/akveo/blur-admin/blob/master/src/app/theme/components/components.module.js"
click node_theme_plumbing "https://github.com/akveo/blur-admin/blob/master/src/app/theme/theme.service.js"
click node_dashboard_widgets "https://github.com/akveo/blur-admin/tree/master/src/app/pages/dashboard"
click node_chart_integrations "https://github.com/akveo/blur-admin/tree/master/src/app/pages/charts"
click node_map_integrations "https://github.com/akveo/blur-admin/tree/master/src/app/pages/maps"
click node_form_widgets "https://github.com/akveo/blur-admin/tree/master/src/app/pages/form/inputs/widgets"
click node_src_sass "https://github.com/akveo/blur-admin/tree/master/src/sass"
click node_src_assets "https://github.com/akveo/blur-admin/tree/master/src/assets"
click node_gulp_pipeline "https://github.com/akveo/blur-admin/blob/master/gulpfile.js"
click node_docs_site "https://github.com/akveo/blur-admin/tree/master/docs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_src_index,node_src_auth,node_src_reg,node_src_404,node_app_root,node_pages_module,node_theme_module,node_dashboard_page,node_charts_page,node_maps_page,node_forms_page,node_ui_page,node_tables_page,node_profile_page,node_components_page,node_theme_components,node_theme_plumbing,node_dashboard_widgets,node_chart_integrations,node_map_integrations,node_form_widgets,node_src_assets toneBlue
class node_src_sass toneAmber
class node_gulp_pipeline,node_docs_site toneMint
```

## Components

### Runtime app

AngularJS SPA and entry pages

- [Main entry](https://github.com/akveo/blur-admin/blob/master/src/index.html): html entry · Primary browser entry for the admin SPA · `src/index.html`
- [Auth page](https://github.com/akveo/blur-admin/blob/master/src/auth.html): html entry · Standalone login/auth entry · `src/auth.html`
- [Register page](https://github.com/akveo/blur-admin/blob/master/src/reg.html): html entry · Standalone registration entry · `src/reg.html`
- [Fallback page](https://github.com/akveo/blur-admin/blob/master/src/404.html): html entry · Standalone 404 view · `src/404.html`
- [App bootstrap](https://github.com/akveo/blur-admin/blob/master/src/app/app.js): angular root · Top-level AngularJS application wiring · `src/app/app.js`
- [Pages layer](https://github.com/akveo/blur-admin/blob/master/src/app/pages/pages.module.js): angular feature shell · Feature-screen modules for the admin app · `src/app/pages/pages.module.js`
- [Theme layer](https://github.com/akveo/blur-admin/blob/master/src/app/theme/theme.module.js): shared UI shell · Reusable chrome, UI plumbing, and cross-cutting services · `src/app/theme/theme.module.js`
- [Dashboard](https://github.com/akveo/blur-admin/blob/master/src/app/pages/dashboard/dashboard.module.js): feature module · Widget-heavy landing dashboard · `src/app/pages/dashboard/dashboard.module.js`
- [Charts](https://github.com/akveo/blur-admin/blob/master/src/app/pages/charts/charts.module.js): feature module · Visualization pages wrapping chart libraries · `src/app/pages/charts/charts.module.js`
- [Maps](https://github.com/akveo/blur-admin/blob/master/src/app/pages/maps/maps.module.js): feature module · Map integrations and overlays · `src/app/pages/maps/maps.module.js`
- [Forms](https://github.com/akveo/blur-admin/blob/master/src/app/pages/form/form.module.js): feature module · Inputs, layouts, and wizard flows · `src/app/pages/form/form.module.js`
- [UI kit](https://github.com/akveo/blur-admin/blob/master/src/app/pages/ui/ui.module.js): feature module · Alerts, buttons, icons, modals, progress, tabs, and more · `src/app/pages/ui/ui.module.js`
- [Tables](https://github.com/akveo/blur-admin/blob/master/src/app/pages/tables/tables.module.js): feature module · Basic and smart table demonstrations · `src/app/pages/tables/tables.module.js`
- [Profile](https://github.com/akveo/blur-admin/blob/master/src/app/pages/profile/profile.module.js): feature module · Profile screen and modal flow · `src/app/pages/profile/profile.module.js`
- [Components](https://github.com/akveo/blur-admin/blob/master/src/app/pages/components/components.module.js): feature module · Mail, timeline, and tree showcase pages · `src/app/pages/components/components.module.js`
- [Theme components](https://github.com/akveo/blur-admin/blob/master/src/app/theme/components/components.module.js): shared components · Sidebar, panels, wizard, top bar, and reusable shell widgets · `src/app/theme/components/components.module.js`
- [Theme plumbing](https://github.com/akveo/blur-admin/blob/master/src/app/theme/theme.service.js): directives/services · Shared directives, filters, inputs, and utility services · `src/app/theme/theme.service.js`
- [Dashboard widgets](https://github.com/akveo/blur-admin/tree/master/src/app/pages/dashboard): dashboard subcomponents · Weather, traffic, todo, map, calendar, and charts · `src/app/pages/dashboard`
- [Chart adapters](https://github.com/akveo/blur-admin/tree/master/src/app/pages/charts): visualization adapters · amCharts, Chart.js, Chartist, and Morris wrappers · `src/app/pages/charts`
- [Map adapters](https://github.com/akveo/blur-admin/tree/master/src/app/pages/maps): map wrappers · Google Maps, Leaflet, and overlay variants · `src/app/pages/maps`
- [Form widgets](https://github.com/akveo/blur-admin/tree/master/src/app/pages/form/inputs/widgets): input controls · Date pickers, selects, switches, tags, and validation demos · `src/app/pages/form/inputs/widgets`
- [UI assets](https://github.com/akveo/blur-admin/tree/master/src/assets): static assets · Fonts, icons, images, skins, and artwork · `src/assets`

### Styling

Sass theme and page styles

- [Sass system](https://github.com/akveo/blur-admin/tree/master/src/sass): style architecture · Centralized styling for theme, pages, and variants · `src/sass`

### Tooling

Build pipeline and docs site

- [Gulp build](https://github.com/akveo/blur-admin/blob/master/gulpfile.js): build pipeline · Styles, scripts, images, injection, server, docs, and release tasks · `gulpfile.js`
- [Docs site](https://github.com/akveo/blur-admin/tree/master/docs): documentation site · Separate documentation portal and content pipeline · `docs`

## Connections

- Main entry → App bootstrap: loads · Main entry loads the Angular app
- App bootstrap → Pages layer: routes to · App bootstraps feature-page modules
- App bootstrap → Theme layer: uses · App bootstraps shared theme shell
- Pages layer → Dashboard: includes · Feature module set includes dashboard
- Pages layer → Charts: includes · Feature module set includes charts
- Pages layer → Maps: includes · Feature module set includes maps
- Pages layer → Forms: includes · Feature module set includes forms
- Pages layer → UI kit: includes · Feature module set includes UI showcase pages
- Pages layer → Tables: includes · Feature module set includes tables
- Pages layer → Profile: includes · Feature module set includes profile
- Pages layer → Components: includes · Feature module set includes shared components pages
- Dashboard → Dashboard widgets: composes · Dashboard page is assembled from smaller widgets
- Charts → Chart adapters: wraps · Charts page wraps multiple chart libraries
- Maps → Map adapters: wraps · Maps page wraps map libraries and overlays
- Forms → Form widgets: contains · Forms feature exposes specialized input widgets
- Theme layer → Theme components: provides · Shared shell components come from the theme layer
- Theme layer → Theme plumbing: provides · Shared directives, filters, inputs, and services come from the theme layer
- Theme layer → UI assets: consumes · Theme layer uses bundled UI assets
- Sass system → Theme layer: styles · Sass architecture skins the shared theme and UI chrome
- Sass system → Pages layer: styles · Sass architecture styles the feature pages
- Gulp build → Sass system: builds · Gulp compiles Sass into distributable styles
- Gulp build → App bootstrap: bundles · Gulp bundles Angular application scripts
- Gulp build → UI assets: packages · Gulp copies and optimizes static assets
- Gulp build → Docs site: generates · Gulp includes a separate docs build flow
- Auth page → Theme layer: shares · Auth page reuses shared theme assets and styling
- Register page → Theme layer: shares · Register page reuses shared theme assets and styling
- Fallback page → Sass system: styled by · Fallback page has dedicated Sass styling
