millas 0.2.8 → 0.2.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "millas",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "A modern batteries-included backend framework for Node.js — built on Express, inspired by Laravel, Django, and FastAPI",
   "main": "src/index.js",
   "exports": {

package/src/admin/views/pages/list.njk

@@ -1,459 +1,5 @@
 {% extends "layouts/base.njk" %}
 
-{% block title %}{{ resource.label }}{% endblock %}
-{% block topbar_title %}
-  <span class="icon icon-16" style="color:var(--text-muted)">
-    <svg viewBox="0 0 24 24"><use href="#ic-{{ resource.icon or 'table' }}"/></svg>
-  </span>
-  {{ resource.label }}
-  <span class="badge badge-gray" style="font-size:11px;font-weight:500">{{ total }}</span>
-{% endblock %}
-
-{% block topbar_actions %}
-  {% if resource.canCreate %}
-  <a href="{{ adminPrefix }}/{{ resource.slug }}/create" class="btn btn-primary">
-    <span class="icon icon-14"><svg viewBox="0 0 24 24"><use href="#ic-plus"/></svg></span>
-    New {{ resource.singular }}
-  </a>
-  {% endif %}
-{% endblock %}
-
-{% block content %}
-<div class="breadcrumb">
-  <a href="{{ adminPrefix }}/">
-    <span class="icon icon-12"><svg viewBox="0 0 24 24"><use href="#ic-grid"/></svg></span>
-  </a>
-  <span class="breadcrumb-sep">›</span>
-  <span class="breadcrumb-current">{{ resource.label }}</span>
-  {% if year %}
-  <span class="breadcrumb-sep">›</span>
-  <span class="breadcrumb-current">{{ year }}</span>
-  {% endif %}
-  {% if month %}
-  <span class="breadcrumb-sep">›</span>
-  <span class="breadcrumb-current">{{ month }}</span>
-  {% endif %}
-</div>
-
-{# ── Date hierarchy ── #}
-{% if resource.dateHierarchy %}
-<div class="date-hierarchy mb-4">
-  <a href="{{ adminPrefix }}/{{ resource.slug }}" class="dh-btn {% if not year %}active{% endif %}">All</a>
-  {% for y in dateYears %}
-  <a href="{{ adminPrefix }}/{{ resource.slug }}?year={{ y }}" class="dh-btn {% if year == y %}active{% endif %}">{{ y }}</a>
-  {% endfor %}
-  {% if year %}
-  <span class="dh-sep">›</span>
-  {% set monthNames = ['Jan','Feb','Mar','Apr','May','Jun','Jul','Aug','Sep','Oct','Nov','Dec'] %}
-  {% for m in range(1, 13) %}
-  <a href="{{ adminPrefix }}/{{ resource.slug }}?year={{ year }}&month={{ m }}" class="dh-btn {% if month == m %}active{% endif %}">{{ monthNames[m-1] }}</a>
-  {% endfor %}
-  {% endif %}
-</div>
-{% endif %}
-
-<div class="card">
-
-  {# ── Toolbar ── #}
-  <div class="toolbar">
-    <div class="toolbar-left">
-      <form method="GET" action="{{ adminPrefix }}/{{ resource.slug }}" id="search-form" style="display:flex;gap:8px;align-items:center">
-        <input type="hidden" name="sort"    value="{{ sort }}">
-        <input type="hidden" name="order"   value="{{ order }}">
-        <input type="hidden" name="perPage" value="{{ perPage }}">
-        {% if year  %}<input type="hidden" name="year"  value="{{ year }}">{% endif %}
-        {% if month %}<input type="hidden" name="month" value="{{ month }}">{% endif %}
-        {% for key, val in activeFilters %}
-        <input type="hidden" name="filter[{{ key }}]" value="{{ val }}">
-        {% endfor %}
-        <div class="search-wrap">
-          <span class="search-icon-inner">
-            <svg viewBox="0 0 24 24" width="14" height="14" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-              <circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/>
-            </svg>
-          </span>
-          <input type="text" name="search" value="{{ search }}"
-            placeholder="Search {{ resource.label | lower }}…"
-            class="form-control search-input" autocomplete="off">
-        </div>
-        {% if search %}
-        <a href="{{ adminPrefix }}/{{ resource.slug }}" class="btn btn-ghost btn-sm">
-          <span class="icon icon-13"><svg viewBox="0 0 24 24"><use href="#ic-x"/></svg></span>
-          Clear
-        </a>
-        {% endif %}
-      </form>
-    </div>
-
-    <div class="toolbar-right">
-      {# Per-page selector #}
-      <select class="filter-control" style="min-width:80px" onchange="changePerPage(this.value)" title="Rows per page">
-        {% for n in [20, 50, 100] %}
-        <option value="{{ n }}" {% if perPage == n %}selected{% endif %}>{{ n }} / page</option>
-        {% endfor %}
-      </select>
-
-      {% if filters | length %}
-      <button class="btn btn-ghost btn-sm" onclick="toggleFilters()" id="filter-toggle">
-        <span class="icon icon-13"><svg viewBox="0 0 24 24"><use href="#ic-filter"/></svg></span>
-        Filters
-        {% if activeFilters | length %}
-        <span class="badge badge-blue" style="font-size:10px;padding:1px 5px">{{ activeFilters | length }}</span>
-        {% endif %}
-      </button>
-      {% endif %}
-
-      {# Export dropdown #}
-      <div class="action-menu">
-        <button class="btn btn-ghost btn-sm action-menu-btn">
-          <span class="icon icon-13"><svg viewBox="0 0 24 24"><use href="#ic-download"/></svg></span>
-          Export
-          <span class="icon icon-12"><svg viewBox="0 0 24 24"><use href="#ic-chevron-down"/></svg></span>
-        </button>
-        <div class="action-dropdown" style="right:0;min-width:160px">
-          <a href="{{ adminPrefix }}/{{ resource.slug }}/export.csv?search={{ search }}&sort={{ sort }}&order={{ order }}{% for key, val in activeFilters %}&filter[{{ key }}]={{ val }}{% endfor %}">
-            <span class="icon icon-13"><svg viewBox="0 0 24 24"><use href="#ic-download"/></svg></span>
-            Export CSV
-          </a>
-          <a href="{{ adminPrefix }}/{{ resource.slug }}/export.json?search={{ search }}&sort={{ sort }}&order={{ order }}{% for key, val in activeFilters %}&filter[{{ key }}]={{ val }}{% endfor %}">
-            <span class="icon icon-13"><svg viewBox="0 0 24 24"><use href="#ic-download"/></svg></span>
-            Export JSON
-          </a>
-        </div>
-      </div>
-    </div>
-  </div>
-
-  {# ── Bulk action bar ── #}
-  <div class="bulk-bar" id="bulk-bar">
-    <span class="bulk-count" id="bulk-count">0 selected</span>
-    <span class="text-muted" style="font-size:12px">—</span>
-
-    {# Built-in delete #}
-    {% if resource.canDelete %}
-    <button class="btn btn-ghost btn-sm btn-danger" onclick="bulkDelete()">
-      <span class="icon icon-13"><svg viewBox="0 0 24 24"><use href="#ic-trash"/></svg></span>
-      Delete selected
-    </button>
-    {% endif %}
-
-    {# Custom bulk actions #}
-    {% for action in resource.actions %}
-    <button class="btn btn-ghost btn-sm" onclick="submitBulkAction({{ action.index }})">
-      <span class="icon icon-13"><svg viewBox="0 0 24 24"><use href="#ic-{{ action.icon or 'check' }}"/></svg></span>
-      {{ action.label }}
-    </button>
-    {% endfor %}
-
-    <button class="btn btn-ghost btn-sm" style="margin-left:auto" onclick="clearSelection()">
-      <span class="icon icon-13"><svg viewBox="0 0 24 24"><use href="#ic-x"/></svg></span>
-      Cancel
-    </button>
-  </div>
-
-  {# ── Filter panel ── #}
-  {% if filters | length %}
-  <div class="filter-row" id="filter-panel" style="display:none">
-    <form method="GET" action="{{ adminPrefix }}/{{ resource.slug }}" id="filter-form" style="display:flex;gap:10px;flex-wrap:wrap;align-items:flex-end;width:100%">
-      <input type="hidden" name="search"  value="{{ search }}">
-      <input type="hidden" name="sort"    value="{{ sort }}">
-      <input type="hidden" name="order"   value="{{ order }}">
-      <input type="hidden" name="perPage" value="{{ perPage }}">
-
-      {% for filter in filters %}
-      <div class="filter-group">
-        <label class="filter-label">{{ filter.label }}</label>
-        {% if filter.type == 'select' %}
-        <select name="filter[{{ filter.name }}]" class="filter-control" style="min-width:120px" onchange="this.form.submit()">
-          <option value="">All</option>
-          {% for opt in filter.options %}
-          <option value="{{ opt }}" {% if activeFilters[filter.name] == opt %}selected{% endif %}>{{ opt }}</option>
-          {% endfor %}
-        </select>
-        {% elif filter.type == 'boolean' %}
-        <select name="filter[{{ filter.name }}]" class="filter-control" style="min-width:100px" onchange="this.form.submit()">
-          <option value="">All</option>
-          <option value="1" {% if activeFilters[filter.name] == '1' %}selected{% endif %}>Yes</option>
-          <option value="0" {% if activeFilters[filter.name] == '0' %}selected{% endif %}>No</option>
-        </select>
-        {% elif filter.type == 'text' %}
-        <input type="text" name="filter[{{ filter.name }}]" class="filter-control" style="min-width:130px"
-          value="{{ activeFilters[filter.name] or '' }}" placeholder="Filter…">
-        {% elif filter.type == 'number' %}
-        <input type="number" name="filter[{{ filter.name }}]" class="filter-control" style="min-width:100px"
-          value="{{ activeFilters[filter.name] or '' }}" placeholder="0">
-        {% elif filter.type == 'dateRange' %}
-        <div style="display:flex;gap:6px;align-items:center">
-          <input type="date" name="filter[{{ filter.name }}__gte]" class="filter-control"
-            value="{{ activeFilters[filter.name + '__gte'] or '' }}" placeholder="From">
-          <span style="color:var(--text-muted);font-size:12px">→</span>
-          <input type="date" name="filter[{{ filter.name }}__lte]" class="filter-control"
-            value="{{ activeFilters[filter.name + '__lte'] or '' }}" placeholder="To">
-        </div>
-        {% endif %}
-      </div>
-      {% endfor %}
-
-      <div class="filter-group" style="flex-direction:row;align-items:flex-end;gap:6px;margin-left:auto">
-        <button type="submit" class="btn btn-ghost btn-sm">Apply</button>
-        {% if activeFilters | length %}
-        <a href="{{ adminPrefix }}/{{ resource.slug }}{% if search %}?search={{ search }}{% endif %}" class="btn btn-ghost btn-sm">
-          <span class="icon icon-12"><svg viewBox="0 0 24 24"><use href="#ic-x"/></svg></span>
-          Reset
-        </a>
-        {% endif %}
-      </div>
-    </form>
-  </div>
-  {% endif %}
-
-  {# ── Table ── #}
-  <div class="table-wrap">
-    {% if rows | length %}
-    <table id="data-table">
-      <thead>
-        <tr>
-          <th class="col-check">
-            <input type="checkbox" class="row-check" id="check-all" onchange="toggleAll(this)">
-          </th>
-          {% for field in listFields %}
-          {% set isSorted = sort == field.name %}
-          <th class="{% if field.name in sortable %}sortable{% endif %} {% if isSorted %}sort-{{ order }} sort-active{% endif %}">
-            {% if field.name in sortable %}
-            <a href="{{ adminPrefix }}/{{ resource.slug }}?sort={{ field.name }}&order={{ 'desc' if (isSorted and order == 'asc') else 'asc' }}&search={{ search }}&page={{ page }}&perPage={{ perPage }}" style="color:inherit;text-decoration:none;display:flex;align-items:center;gap:4px">
-              {{ field.label }}
-              <span class="sort-indicator"><span class="up"></span><span class="down"></span></span>
-            </a>
-            {% else %}
-            {{ field.label }}
-            {% endif %}
-          </th>
-          {% endfor %}
-          {% if resource.canEdit or resource.canDelete or resource.rowActions | length %}
-          <th class="col-actions">Actions</th>
-          {% endif %}
-        </tr>
-      </thead>
-      <tbody>
-        {% for row in rows %}
-        <tr data-id="{{ row.id }}">
-          <td class="col-check">
-            <input type="checkbox" class="row-check item-check" value="{{ row.id }}" onchange="updateBulkBar()">
-          </td>
-          {% for field in listFields %}
-          <td class="{% if loop.first %}td-primary{% endif %}">
-            {# listDisplayLinks: make column value a link to detail page #}
-            {% if loop.first or field.name in resource.listDisplayLinks or field.isLink %}
-              {% if resource.canView %}
-              <a href="{{ adminPrefix }}/{{ resource.slug }}/{{ row.id }}" style="color:inherit;text-decoration:none">
-                {{ row[field.name] | adminCell(field) | safe }}
-              </a>
-              {% else %}
-              {{ row[field.name] | adminCell(field) | safe }}
-              {% endif %}
-            {% else %}
-            {{ row[field.name] | adminCell(field) | safe }}
-            {% endif %}
-          </td>
-          {% endfor %}
-          {% if resource.canEdit or resource.canDelete or resource.rowActions | length %}
-          <td class="col-actions">
-            <div class="action-menu">
-              <button class="action-menu-btn">
-                <span class="icon icon-14">
-                  <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
-                    <circle cx="12" cy="5" r="1.2" fill="currentColor" stroke="none"/>
-                    <circle cx="12" cy="12" r="1.2" fill="currentColor" stroke="none"/>
-                    <circle cx="12" cy="19" r="1.2" fill="currentColor" stroke="none"/>
-                  </svg>
-                </span>
-              </button>
-              <div class="action-dropdown">
-                {% if resource.canView %}
-                <a href="{{ adminPrefix }}/{{ resource.slug }}/{{ row.id }}">
-                  <span class="icon icon-13"><svg viewBox="0 0 24 24"><use href="#ic-eye"/></svg></span>
-                  View
-                </a>
-                {% endif %}
-                {% if resource.canEdit %}
-                <a href="{{ adminPrefix }}/{{ resource.slug }}/{{ row.id }}/edit">
-                  <span class="icon icon-13"><svg viewBox="0 0 24 24"><use href="#ic-edit"/></svg></span>
-                  Edit
-                </a>
-                {% endif %}
-                {# Custom row actions #}
-                {% for ra in resource.rowActions %}
-                {% if ra.href %}
-                <a href="{{ ra.href }}" target="_blank" rel="noopener">
-                  <span class="icon icon-13"><svg viewBox="0 0 24 24"><use href="#ic-{{ ra.icon or 'arrow-right' }}"/></svg></span>
-                  {{ ra.label }}
-                </a>
-                {% elif ra.action %}
-                <form method="POST" action="{{ adminPrefix }}/{{ resource.slug }}/{{ row.id }}/action/{{ ra.action }}" style="display:contents">
-                  <button type="submit">
-                    <span class="icon icon-13"><svg viewBox="0 0 24 24"><use href="#ic-{{ ra.icon or 'check' }}"/></svg></span>
-                    {{ ra.label }}
-                  </button>
-                </form>
-                {% endif %}
-                {% endfor %}
-                {% if resource.canDelete %}
-                <div class="sep"></div>
-                <button class="danger" onclick="confirmDelete('{{ adminPrefix }}/{{ resource.slug }}/{{ row.id }}/delete', '#{{ row.id }}')">
-                  <span class="icon icon-13"><svg viewBox="0 0 24 24"><use href="#ic-trash"/></svg></span>
-                  Delete
-                </button>
-                {% endif %}
-              </div>
-            </div>
-          </td>
-          {% endif %}
-        </tr>
-        {% endfor %}
-      </tbody>
-    </table>
-
-    {# ── Pagination ── #}
-    {% if lastPage > 1 %}
-    <div class="pagination">
-      <a class="page-btn {% if page <= 1 %}disabled{% endif %}"
-        href="{{ adminPrefix }}/{{ resource.slug }}?page={{ page - 1 }}&sort={{ sort }}&order={{ order }}&search={{ search }}&perPage={{ perPage }}"
-        {% if page <= 1 %}tabindex="-1" aria-disabled="true"{% endif %}>
-        <span class="icon icon-13"><svg viewBox="0 0 24 24"><use href="#ic-chevron-left"/></svg></span>
-      </a>
-      {% for p in range(1, lastPage + 1) %}
-        {% if p == 1 or p == lastPage or (p >= page - 2 and p <= page + 2) %}
-          <a class="page-btn {% if p == page %}active{% endif %}"
-            href="{{ adminPrefix }}/{{ resource.slug }}?page={{ p }}&sort={{ sort }}&order={{ order }}&search={{ search }}&perPage={{ perPage }}">{{ p }}</a>
-        {% elif p == 2 and page > 4 %}
-          <span class="page-ellipsis">…</span>
-        {% elif p == lastPage - 1 and page < lastPage - 3 %}
-          <span class="page-ellipsis">…</span>
-        {% endif %}
-      {% endfor %}
-      <a class="page-btn {% if page >= lastPage %}disabled{% endif %}"
-        href="{{ adminPrefix }}/{{ resource.slug }}?page={{ page + 1 }}&sort={{ sort }}&order={{ order }}&search={{ search }}&perPage={{ perPage }}"
-        {% if page >= lastPage %}tabindex="-1" aria-disabled="true"{% endif %}>
-        <span class="icon icon-13"><svg viewBox="0 0 24 24"><use href="#ic-chevron-right"/></svg></span>
-      </a>
-      <span class="page-info">
-        {{ (page - 1) * perPage + 1 }}–{{ [page * perPage, total] | min }} of {{ total }}
-      </span>
-    </div>
-    {% endif %}
-
-    {% else %}
-    <div class="empty-state">
-      <div class="empty-icon">
-        <span class="icon icon-22"><svg viewBox="0 0 24 24"><use href="#ic-table"/></svg></span>
-      </div>
-      <div class="empty-title">No {{ resource.label }} found</div>
-      <div class="empty-desc">
-        {% if search %}No results for "<strong>{{ search }}</strong>".
-        {% elif activeFilters | length %}No records match the active filters.
-        {% else %}Get started by creating your first record.{% endif %}
-      </div>
-      {% if resource.canCreate %}
-      <a href="{{ adminPrefix }}/{{ resource.slug }}/create" class="btn btn-primary">
-        <span class="icon icon-14"><svg viewBox="0 0 24 24"><use href="#ic-plus"/></svg></span>
-        New {{ resource.singular }}
-      </a>
-      {% endif %}
-    </div>
-    {% endif %}
-  </div>
-</div>
-
-{# Hidden bulk action form #}
-<form method="POST" action="{{ adminPrefix }}/{{ resource.slug }}/bulk-action" id="bulk-action-form" style="display:none">
-  <input type="hidden" name="actionIndex" id="bulk-action-index" value="">
-  <div id="bulk-action-ids"></div>
-</form>
-
-<style>
-  /* ── Date hierarchy ── */
-  .date-hierarchy {
-    display: flex; align-items: center; gap: 4px; flex-wrap: wrap;
-    padding: 10px 0;
-  }
-  .dh-btn {
-    padding: 4px 10px; border-radius: 99px; font-size: 12.5px;
-    border: 1px solid var(--border); background: var(--surface);
-    color: var(--text-muted); text-decoration: none; font-weight: 500;
-    transition: all .12s;
-  }
-  .dh-btn:hover  { border-color: var(--primary); color: var(--primary); }
-  .dh-btn.active { background: var(--primary); border-color: var(--primary); color: #fff; }
-  .dh-sep { color: var(--text-xmuted); font-size: 13px; padding: 0 2px; }
-</style>
-
-<script>
-  // ── Filter panel ──────────────────────────────────────────────
-  const filterPanel = document.getElementById('filter-panel');
-  {% if activeFilters | length %}
-  if (filterPanel) filterPanel.style.display = 'flex';
-  {% endif %}
-  function toggleFilters() {
-    if (!filterPanel) return;
-    filterPanel.style.display = filterPanel.style.display === 'none' ? 'flex' : 'none';
-  }
-
-  // ── Per-page selector ─────────────────────────────────────────
-  function changePerPage(val) {
-    const url = new URL(window.location.href);
-    url.searchParams.set('perPage', val);
-    url.searchParams.set('page', '1');
-    window.location.href = url.toString();
-  }
-
-  // ── Bulk selection ────────────────────────────────────────────
-  const bulkBar   = document.getElementById('bulk-bar');
-  const bulkCount = document.getElementById('bulk-count');
-
-  function updateBulkBar() {
-    const checked = document.querySelectorAll('.item-check:checked');
-    const n = checked.length;
-    bulkBar.classList.toggle('visible', n > 0);
-    if (bulkCount) bulkCount.textContent = `${n} selected`;
-    const all = document.getElementById('check-all');
-    if (all) {
-      const total = document.querySelectorAll('.item-check').length;
-      all.indeterminate = n > 0 && n < total;
-      all.checked = n > 0 && n === total;
-    }
-  }
-
-  function toggleAll(master) {
-    document.querySelectorAll('.item-check').forEach(c => { c.checked = master.checked; });
-    updateBulkBar();
-  }
-
-  function clearSelection() {
-    document.querySelectorAll('.item-check, #check-all').forEach(c => { c.checked = false; c.indeterminate = false; });
-    updateBulkBar();
-  }
-
-  function bulkDelete() {
-    const ids = [...document.querySelectorAll('.item-check:checked')].map(c => c.value);
-    if (!ids.length) return;
-    confirmDelete(
-      '{{ adminPrefix }}/{{ resource.slug }}/bulk-delete',
-      `${ids.length} record${ids.length > 1 ? 's' : ''}`
-    );
-  }
-
-  function submitBulkAction(actionIndex) {
-    const ids = [...document.querySelectorAll('.item-check:checked')].map(c => c.value);
-    if (!ids.length) return;
-    const form = document.getElementById('bulk-action-form');
-    const container = document.getElementById('bulk-action-ids');
-    document.getElementById('bulk-action-index').value = actionIndex;
-    container.innerHTML = ids.map(id => `<input type="hidden" name="ids[]" value="${id}">`).join('');
-    form.submit();
-  }
-</script>
-{% endblock %}
-
 {% block title %}{{ resource.label }}{% endblock %}
 {% block topbar_title %}
   <span class="icon icon-16" style="color:var(--text-muted)">

package/src/container/MillasApp.js

@@ -0,0 +1,307 @@
+'use strict';
+
+const express  = require('express');
+const Application = require('./Application');
+
+/**
+ * MillasApp
+ *
+ * A clean factory wrapper around Application that wires up Express,
+ * core providers, routes, and the admin panel automatically.
+ *
+ * Reduces bootstrap/app.js from ~60 lines to ~8.
+ *
+ * ── Usage ───────────────────────────────────────────────────────────────────
+ *
+ *   require('dotenv').config();
+ *   const { MillasApp } = require('millas');
+ *   const AppServiceProvider = require('../providers/AppServiceProvider');
+ *
+ *   const app = MillasApp.create()
+ *     .providers([AppServiceProvider])
+ *     .routes(Route => {
+ *       require('../routes/web')(Route);
+ *       require('../routes/api')(Route);
+ *     })
+ *     .withAdmin();
+ *
+ *   module.exports = app.start();
+ *
+ * ── Escape hatches ──────────────────────────────────────────────────────────
+ *
+ *   // Access the raw Express app
+ *   app.express.use(someExpressMiddleware());
+ *
+ *   // Access the DI container
+ *   app.container.make('db');
+ *
+ *   // Access the underlying Application kernel
+ *   app.kernel
+ *
+ * ── Advanced ────────────────────────────────────────────────────────────────
+ *
+ *   MillasApp.create({
+ *     // Disable a core provider
+ *     mail:    false,
+ *     queue:   false,
+ *
+ *     // Custom admin prefix
+ *     admin:   { prefix: '/cms', title: 'My CMS' },
+ *
+ *     // Add Express middleware before routes
+ *     expressMiddleware: [cors(), helmet()],
+ *
+ *     // Called once the app is listening
+ *     onStart: (port, host) => console.log(`Running on ${host}:${port}`),
+ *   })
+ */
+class MillasApp {
+
+  // ─── Factory ──────────────────────────────────────────────────────────────
+
+  /**
+   * Create a new MillasApp instance.
+   * @param {object} [options]
+   * @param {boolean} [options.database=true]   — register DatabaseServiceProvider
+   * @param {boolean} [options.cache=true]      — register CacheServiceProvider
+   * @param {boolean} [options.storage=true]    — register StorageServiceProvider
+   * @param {boolean} [options.mail=true]       — register MailServiceProvider
+   * @param {boolean} [options.queue=true]      — register QueueServiceProvider
+   * @param {boolean} [options.events=true]     — register EventServiceProvider
+   * @param {boolean} [options.logging=true]    — register LogServiceProvider
+   * @param {Array}   [options.expressMiddleware] — Express middleware applied before routes
+   * @param {Function}[options.onStart]         — callback(port, host) after listen
+   */
+  static create(options = {}) {
+    return new MillasApp(options);
+  }
+
+  constructor(options = {}) {
+    this._options      = options;
+    this._userProviders = [];
+    this._routesCb     = null;
+    this._adminOptions = null;   // null = no admin; object/true = mount admin
+    this._expressApp   = null;
+    this._kernel       = null;
+    this._started      = false;
+  }
+
+  // ─── Fluent API ───────────────────────────────────────────────────────────
+
+  /**
+   * Register application service providers.
+   *
+   *   .providers([AppServiceProvider, PaymentServiceProvider])
+   */
+  providers(list = []) {
+    this._userProviders.push(...list);
+    return this;
+  }
+
+  /**
+   * Define application routes.
+   *
+   *   .routes(Route => {
+   *     require('../routes/web')(Route);
+   *     require('../routes/api')(Route);
+   *   })
+   */
+  routes(callback) {
+    this._routesCb = callback;
+    return this;
+  }
+
+  /**
+   * Register a named middleware alias.
+   * Must be called before start().
+   *
+   *   .middleware('verified', EmailVerifiedMiddleware)
+   */
+  middleware(alias, handler) {
+    if (!this._pendingMiddleware) this._pendingMiddleware = [];
+    this._pendingMiddleware.push({ alias, handler });
+    return this;
+  }
+
+  /**
+   * Mount the admin panel.
+   *
+   *   .withAdmin()                          // default /admin
+   *   .withAdmin({ prefix: '/cms' })        // custom prefix
+   *   .withAdmin({ prefix: '/admin', auth: { users: [...] } })
+   */
+  withAdmin(options = {}) {
+    this._adminOptions = options;
+    return this;
+  }
+
+  // ─── Start ────────────────────────────────────────────────────────────────
+
+  /**
+   * Boot all providers, mount routes, and start listening.
+   * Returns an object with { app, expressApp, route } for module.exports.
+   *
+   * Safe to await if you need to run code after boot:
+   *   const { app } = await MillasApp.create()...start();
+   */
+  start() {
+    // Build Express + Application kernel
+    this._expressApp = express();
+    this._expressApp.use(express.json());
+    this._expressApp.use(express.urlencoded({ extended: true }));
+
+    // Apply any extra Express middleware (e.g. helmet, cors)
+    for (const mw of (this._options.expressMiddleware || [])) {
+      this._expressApp.use(mw);
+    }
+
+    this._kernel = new Application(this._expressApp);
+
+    // Register pending middleware aliases
+    for (const { alias, handler } of (this._pendingMiddleware || [])) {
+      this._kernel.middleware(alias, handler);
+    }
+
+    // Register core providers (auto, unless disabled)
+    const coreProviders = this._buildCoreProviders();
+    this._kernel.providers([...coreProviders, ...this._userProviders]);
+
+    // Register routes
+    if (this._routesCb) {
+      this._kernel.routes(this._routesCb);
+    }
+
+    // Boot asynchronously
+    const self = this;
+    const boot = (async () => {
+      await self._kernel.boot();
+
+      if (!process.env.MILLAS_ROUTE_LIST) {
+        self._kernel.mountRoutes();
+
+        // Admin panel (mounted between routes and fallbacks)
+        if (self._adminOptions !== null) {
+          const adminOpts = typeof self._adminOptions === 'object'
+            ? self._adminOptions
+            : {};
+
+          try {
+            const Admin = require('../admin/Admin');
+            if (Object.keys(adminOpts).length) {
+              Admin.configure(adminOpts);
+            }
+            Admin.mount(self._expressApp);
+          } catch (err) {
+            process.stderr.write(`[millas] Admin mount failed: ${err.message}\n`);
+          }
+        }
+
+        self._kernel.mountFallbacks();
+
+        const onStart = self._options.onStart || null;
+        self._kernel.listen(undefined, undefined, onStart || undefined);
+      }
+
+      self._started = true;
+    })();
+
+    // Expose the promise for testing / programmatic use
+    this._bootPromise = boot;
+
+    return this;
+  }
+
+  /**
+   * Await the boot promise. Useful in tests or scripts.
+   *
+   *   const app = await MillasApp.create().routes(...).start().ready();
+   */
+  async ready() {
+    await (this._bootPromise || Promise.resolve());
+    return this;
+  }
+
+  // ─── Escape hatches ───────────────────────────────────────────────────────
+
+  /** The raw Express application instance. */
+  get express()    { return this._expressApp; }
+
+  /** The underlying Application kernel. */
+  get kernel()     { return this._kernel; }
+
+  /** The DI container. */
+  get container()  { return this._kernel?._container; }
+
+  /** The Route instance (for programmatic route registration). */
+  get route()      { return this._kernel?._route; }
+
+  // ─── module.exports helper ────────────────────────────────────────────────
+
+  /**
+   * Returns a plain object suitable for module.exports.
+   * Matches the shape existing code expects.
+   */
+  toModule() {
+    const self = this;
+    return {
+      app:        this._kernel,
+      expressApp: this._expressApp,
+      get route() { return self._kernel?._route; },
+    };
+  }
+
+  // ─── Internal ─────────────────────────────────────────────────────────────
+
+  _buildCoreProviders() {
+    const opts = this._options;
+    const providers = [];
+
+    // Helper — require a provider, silently skip if not found
+    const load = (path) => {
+      try { return require(path); } catch { return null; }
+    };
+
+    // Logging — first so all other providers can use Log
+    if (opts.logging !== false) {
+      const p = load('../providers/LogServiceProvider');
+      if (p) providers.push(p);
+    }
+
+    // Database
+    if (opts.database !== false) {
+      const p = load('../providers/DatabaseServiceProvider');
+      if (p) providers.push(p);
+    }
+
+    // Cache + Storage
+    if (opts.cache !== false || opts.storage !== false) {
+      const p = load('../providers/CacheStorageServiceProvider');
+      if (p) {
+        if (opts.cache    !== false && p.CacheServiceProvider)   providers.push(p.CacheServiceProvider);
+        if (opts.storage  !== false && p.StorageServiceProvider) providers.push(p.StorageServiceProvider);
+      }
+    }
+
+    // Mail
+    if (opts.mail !== false) {
+      const p = load('../providers/MailServiceProvider');
+      if (p) providers.push(p);
+    }
+
+    // Queue
+    if (opts.queue !== false) {
+      const p = load('../providers/QueueServiceProvider');
+      if (p) providers.push(p);
+    }
+
+    // Events
+    if (opts.events !== false) {
+      const p = load('../providers/EventServiceProvider');
+      if (p) providers.push(p);
+    }
+
+    return providers;
+  }
+}
+
+module.exports = MillasApp;

package/src/container/index.js

@@ -2,12 +2,14 @@
 
 const Container        = require('./Container');
 const Application      = require('./Application');
+const MillasApp        = require('./MillasApp');
 const ServiceProvider  = require('../providers/ServiceProvider');
 const ProviderRegistry = require('../providers/ProviderRegistry');
 
 module.exports = {
   Container,
   Application,
+  MillasApp,
   ServiceProvider,
   ProviderRegistry,
 };

package/src/index.js

@@ -1,21 +1,5 @@
 'use strict';
 
-// ── Logger ────────────────────────────────────────────────────────
-const {
-  Log,
-  Logger,
-  LEVELS,
-  LEVEL_NAMES,
-  PrettyFormatter,
-  JsonFormatter,
-  SimpleFormatter,
-  ConsoleChannel,
-  FileChannel,
-  NullChannel,
-  StackChannel,
-} = require('./logger/index');
-const LogServiceProvider = require('./providers/LogServiceProvider');
-
 // ── HTTP Layer ────────────────────────────────────────────────────
 const Controller         = require('./controller/Controller');
 const Middleware         = require('./middleware/Middleware');
@@ -28,6 +12,7 @@ const HttpError          = require('./errors/HttpError');
 // ── DI Container ─────────────────────────────────────────────────
 const Container          = require('./container/Container');
 const Application        = require('./container/Application');
+const MillasApp          = require('./container/MillasApp');
 const ServiceProvider    = require('./providers/ServiceProvider');
 const ProviderRegistry   = require('./providers/ProviderRegistry');
 
@@ -76,16 +61,11 @@ const Storage     = require('./storage/Storage');
 const LocalDriver = require('./storage/drivers/LocalDriver');
 
 module.exports = {
-  // Logger
-  Log, Logger, LEVELS, LEVEL_NAMES,
-  PrettyFormatter, JsonFormatter, SimpleFormatter,
-  ConsoleChannel, FileChannel, NullChannel, StackChannel,
-  LogServiceProvider,
   // HTTP
   Controller, Middleware, MiddlewarePipeline,
   CorsMiddleware, ThrottleMiddleware, LogMiddleware, HttpError,
   // DI
-  Container, Application, ServiceProvider, ProviderRegistry,
+  Container, Application, MillasApp, ServiceProvider, ProviderRegistry,
   // ORM
   Model, fields, QueryBuilder, DatabaseManager, SchemaBuilder,
   MigrationRunner, ModelInspector, DatabaseServiceProvider,

package/src/scaffold/templates.js

@@ -88,77 +88,18 @@ module.exports = {
 
 require('dotenv').config();
 
-const express = require('express');
-
-function resolveMillas() {
-  try { return require('millas/src'); } catch {}
-  try {
-    const path     = require('path');
-    const cliPath  = require.resolve('millas/bin/millas.js');
-    const millasSrc = path.join(path.dirname(cliPath), '..', 'src', 'index.js');
-    return require(millasSrc);
-  } catch {}
-  throw new Error('Cannot find millas. Run: npm install millas');
-}
-
-const {
-  Application,
-  Admin,
-  LogServiceProvider,
-  CacheServiceProvider,
-  StorageServiceProvider,
-  MailServiceProvider,
-  QueueServiceProvider,
-  EventServiceProvider,
-} = resolveMillas();
-
+const { MillasApp } = require('millas');
 const AppServiceProvider = require('../providers/AppServiceProvider');
 
-const expressApp = express();
-expressApp.use(express.json());
-expressApp.use(express.urlencoded({ extended: true }));
-
-// ── Build the Millas application kernel ─────────────────────────
-const app = new Application(expressApp);
-
-// ── Register service providers ──────────────────────────────────
-app.providers([
-  LogServiceProvider,       // first — so Log works in all other providers
-  CacheServiceProvider,
-  StorageServiceProvider,
-  MailServiceProvider,
-  QueueServiceProvider,
-  EventServiceProvider,
-  AppServiceProvider,
-]);
-
-// ── Define routes ────────────────────────────────────────────────
-app.routes(Route => {
-  require('../routes/web')(Route);
-  require('../routes/api')(Route);
-});
-
-// ── Boot + mount + listen ────────────────────────────────────────
-(async () => {
-  await app.boot();
-
-  if (!process.env.MILLAS_ROUTE_LIST) {
-    // Register app routes first (without 404 handler yet)
-    app.mountRoutes();
-
-    // Admin panel mounts here — before the 404 fallback
-    // To disable: comment out this line
-    // To change path: Admin.configure({ prefix: '/cms' });
-    Admin.mount(expressApp);
-
-    // Add 404 + error handlers LAST
-    app.mountFallbacks();
-
-    app.listen();
-  }
-})();
+const app = MillasApp.create()
+  .providers([AppServiceProvider])
+  .routes(Route => {
+    require('../routes/web')(Route);
+    require('../routes/api')(Route);
+  })
+  .withAdmin();
 
-module.exports = { app, expressApp, get route() { return app.route; } };
+module.exports = app.start();
 `,
 
     // ─── routes/web.js ────────────────────────────────────────────
@@ -198,38 +139,6 @@ module.exports = function (Route) {
 
   });
 };
-`,
-
-    // ─── config/logging.js ────────────────────────────────────────
-    'config/logging.js': `'use strict';
-
-/**
- * Logging Configuration
- *
- * Levels (lowest → highest): verbose | debug | info | warn | error | wtf
- * Channels: 'console' | 'file' | 'null'
- * Formats:  'pretty' (coloured) | 'simple' (plain text) | 'json' (structured)
- */
-module.exports = {
-  level: process.env.LOG_LEVEL || (process.env.NODE_ENV === 'production' ? 'info' : 'debug'),
-
-  defaultTag: process.env.APP_NAME || 'App',
-
-  channels: [
-    {
-      driver: 'console',
-      format: 'pretty',
-    },
-    {
-      driver:   'file',
-      format:   'simple',
-      path:     'storage/logs',
-      prefix:   '${projectName}',
-      level:    'warn',
-      maxFiles: 30,
-    },
-  ],
-};
 `,
 
     // ─── config/app.js ────────────────────────────────────────────
@@ -332,25 +241,15 @@ module.exports = {
     // ─── providers/AppServiceProvider.js ──────────────────────────
     'providers/AppServiceProvider.js': `'use strict';
 
-function resolveMillas() {
-  try { return require('millas/src'); } catch {}
-  try {
-    const path = require('path');
-    const cli  = require.resolve('millas/bin/millas.js');
-    return require(path.join(path.dirname(cli), '..', 'src', 'index.js'));
-  } catch {}
-  throw new Error('Cannot find millas. Run: npm install millas');
-}
-
-const { ServiceProvider } = resolveMillas();
+const { ServiceProvider } = require('millas');
 
 /**
  * AppServiceProvider
  *
  * Register and bootstrap your application services here.
  *
- * register()  — bind things into the container
- * boot()      — called after all providers have registered
+ * register()  — bind things into the container (synchronous)
+ * boot()      — called after all providers have registered (async OK)
  */
 class AppServiceProvider extends ServiceProvider {
   register(container) {
@@ -360,7 +259,13 @@ class AppServiceProvider extends ServiceProvider {
   }
 
   async boot(container, app) {
-    // const logger = container.make('Logger');
+    // const { Log } = require('millas');
+    // Log.tag('AppServiceProvider').i('Booted');
+
+    // Register resources in the Admin panel:
+    // const { Admin, AdminResource } = require('millas');
+    // const Post = require('../app/models/Post');
+    // Admin.register(Post);
   }
 }