domma-cms 0.1.0

package/admin/js/views/settings.js

@@ -0,0 +1,64 @@
+/**
+ * Settings View
+ */
+import { api } from '../api.js';
+
+export const settingsView = {
+    templateUrl: '/admin/js/templates/settings.html',
+
+    async onMount($container) {
+        const s = await api.settings.get().catch(() => ({}));
+        $container.find('#field-site-title').val(s.title || '');
+        $container.find('#field-tagline').val(s.tagline || '');
+        $container.find('#field-theme').val(s.theme || 'charcoal-dark');
+        $container.find('#field-admin-theme').val(s.adminTheme || 'charcoal-dark');
+        $container.find('#field-seo-title').val(s.seo?.defaultTitle || '');
+        $container.find('#field-seo-separator').val(s.seo?.titleSeparator || ' | ');
+        $container.find('#field-seo-desc').val(s.seo?.defaultDescription || '');
+        $container.find('#field-footer-copy').val(s.footer?.copyright || '');
+
+        // SMTP fields
+        $container.find('#field-smtp-host').val(s.smtp?.host || '');
+        $container.find('#field-smtp-port').val(s.smtp?.port || 587);
+        $container.find('#field-smtp-user').val(s.smtp?.user || '');
+        $container.find('#field-smtp-pass').val(s.smtp?.pass || '');
+        $container.find('#field-smtp-secure').prop('checked', s.smtp?.secure || false);
+        $container.find('#field-smtp-from-address').val(s.smtp?.fromAddress || '');
+        $container.find('#field-smtp-from-name').val(s.smtp?.fromName || '');
+
+        $container.find('#save-settings-btn').on('click', async () => {
+            const adminTheme = $container.find('#field-admin-theme').val();
+            const data = {
+                title: $container.find('#field-site-title').val().trim(),
+                tagline: $container.find('#field-tagline').val().trim(),
+                theme: $container.find('#field-theme').val(),
+                adminTheme,
+                seo: {
+                    defaultTitle: $container.find('#field-seo-title').val().trim(),
+                    titleSeparator: $container.find('#field-seo-separator').val() || ' | ',
+                    defaultDescription: $container.find('#field-seo-desc').val().trim()
+                },
+                footer: {
+                    copyright: $container.find('#field-footer-copy').val().trim(),
+                    links: s.footer?.links || []
+                },
+                smtp: {
+                    host:        $container.find('#field-smtp-host').val().trim(),
+                    port:        parseInt($container.find('#field-smtp-port').val(), 10) || 587,
+                    user:        $container.find('#field-smtp-user').val().trim(),
+                    pass:        $container.find('#field-smtp-pass').val(),
+                    secure:      $container.find('#field-smtp-secure').prop('checked'),
+                    fromAddress: $container.find('#field-smtp-from-address').val().trim(),
+                    fromName:    $container.find('#field-smtp-from-name').val().trim()
+                }
+            };
+            try {
+                await api.settings.save(data);
+                Domma.theme.set(adminTheme);
+                E.toast('Settings saved.', { type: 'success' });
+            } catch {
+                E.toast('Failed to save settings.', { type: 'error' });
+            }
+        });
+    }
+};

package/admin/js/views/tutorials.js

@@ -0,0 +1,12 @@
+/**
+ * Tutorials View
+ * Step-by-step guides for extending and customising Domma CMS.
+ */
+export const tutorialsView = {
+  templateUrl: '/admin/js/templates/tutorials.html',
+
+  async onMount($container) {
+    Domma.icons.scan();
+    Domma.syntax.scan();
+  }
+};

package/admin/js/views/user-editor.js

@@ -0,0 +1,88 @@
+/**
+ * User Editor View
+ * Handles both create (new) and edit (existing) modes using F.render().
+ */
+import { api } from '../api.js';
+
+const ROLES = [
+    { value: 'admin',      label: 'Admin' },
+    { value: 'manager',    label: 'Manager' },
+    { value: 'editor',     label: 'Editor' },
+    { value: 'subscriber', label: 'Subscriber' }
+];
+
+export const userEditorView = {
+    templateUrl: '/admin/js/templates/user-editor.html',
+
+    async onMount($container) {
+        const hash     = window.location.hash;
+        const editMatch = hash.match(/#\/users\/edit\/([^/]+)/);
+        const userId   = editMatch ? editMatch[1] : null;
+        const isEdit   = !!userId;
+
+        let user = null;
+        if (isEdit) {
+            user = await api.users.get(userId).catch(() => null);
+            if (!user) {
+                E.toast('User not found.', { type: 'error' });
+                R.navigate('/users');
+                return;
+            }
+        }
+
+        $container.find('#editor-title').text(isEdit ? 'Edit User' : 'New User');
+        $container.find('#cancel-btn').on('click', () => R.navigate('/users'));
+
+        const blueprint = {
+            name:     { type: 'string',   required: true,    minLength: 2, label: 'Full Name',
+                        formConfig: { placeholder: 'Jane Smith' } },
+            email:    { type: 'email',    required: true,                  label: 'Email Address',
+                        formConfig: { placeholder: 'jane@example.com' } },
+            role:     { type: 'select',   required: true,                  label: 'Role',
+                        options: ROLES },
+            isActive: { type: 'boolean',                                   label: 'Active account' },
+            password: { type: 'password', required: !isEdit, minLength: isEdit ? 0 : 8,
+                        label: isEdit ? 'New Password' : 'Password',
+                        formConfig: { placeholder: '••••••••', autocomplete: 'new-password',
+                                      tooltip: isEdit ? 'Leave blank to keep current password' : 'Minimum 8 characters' } }
+        };
+
+        const initialData = user
+            ? { name: user.name || '', email: user.email || '', role: user.role || 'editor', isActive: user.isActive !== false }
+            : { role: 'editor', isActive: true };
+
+        F.render('#user-form-container', blueprint, initialData, {
+            layout: 'stacked',
+            submitText: isEdit ? 'Update User' : 'Create User',
+            onSubmit: async (data) => {
+                if (isEdit && data.password && data.password.length < 8) {
+                    E.toast('Password must be at least 8 characters.', { type: 'warning' });
+                    return false;
+                }
+
+                const payload = {
+                    name: data.name,
+                    email: data.email,
+                    role: data.role,
+                    isActive: !!data.isActive
+                };
+                if (data.password) payload.password = data.password;
+
+                try {
+                    if (isEdit) {
+                        await api.users.update(userId, payload);
+                    } else {
+                        await api.users.create(payload);
+                    }
+                    E.toast('User saved successfully.', { type: 'success' });
+                    R.navigate('/users');
+                } catch (err) {
+                    E.toast(`Save failed: ${err.message || 'Unknown error'}`, { type: 'error' });
+                    return false;
+                }
+            }
+        });
+
+        Domma.icons.scan();
+    }
+};

package/admin/js/views/users.js

@@ -0,0 +1,73 @@
+/**
+ * Users List View
+ * Shows all users in a Domma table with role badges.
+ */
+import { api, getUser } from '../api.js';
+
+const ROLE_BADGE = {
+    admin:      'badge-danger',
+    manager:    'badge-warning',
+    editor:     'badge-info',
+    subscriber: 'badge-secondary'
+};
+
+export const usersView = {
+    templateUrl: '/admin/js/templates/users.html',
+
+    async onMount($container) {
+        const currentUser = getUser();
+        let users = await api.users.list().catch(() => []);
+
+        const renderTable = (data) => {
+            T.create('#users-table', {
+                data,
+                columns: [
+                    { key: 'name',      label: 'Name' },
+                    { key: 'email',     label: 'Email' },
+                    { key: 'role',      label: 'Role',
+                        render: (val) => `<span class="badge ${ROLE_BADGE[val] || 'badge-secondary'}">${val}</span>` },
+                    { key: 'isActive',  label: 'Status',
+                        render: (val) => val
+                            ? '<span class="badge badge-success">Active</span>'
+                            : '<span class="badge badge-secondary">Inactive</span>' },
+                    { key: 'lastLogin', label: 'Last login',
+                        render: (val) => val ? D(val).format('DD MMM YYYY HH:mm') : 'Never' },
+                    {
+                        key: 'actions', label: 'Actions',
+                        render: (_, row) => {
+                            const isSelf = row.id === currentUser?.id;
+                            return `
+                                <a href="#/users/edit/${row.id}" class="btn btn-sm btn-outline">Edit</a>
+                                ${!isSelf ? `<button class="btn btn-sm btn-danger btn-delete-user" data-id="${row.id}" data-name="${escapeAttr(row.name)}">Delete</button>` : ''}
+                            `;
+                        }
+                    }
+                ],
+                emptyMessage: 'No users found.'
+            });
+            Domma.icons.scan();
+            Domma.effects.reveal('.card', { animation: 'fade', duration: 350 });
+        };
+
+        renderTable(users);
+
+        $container.off('click', '.btn-delete-user').on('click', '.btn-delete-user', async function () {
+            const id   = $(this).data('id');
+            const name = $(this).data('name');
+            const confirmed = await E.confirm(`Delete user <strong>${name}</strong>? This cannot be undone.`);
+            if (!confirmed) return;
+            try {
+                await api.users.delete(id);
+                E.toast('User deleted.', { type: 'success' });
+                users = users.filter(u => u.id !== id);
+                renderTable(users);
+            } catch (err) {
+                E.toast(`Failed to delete: ${err.message}`, { type: 'error' });
+            }
+        });
+    }
+};
+
+function escapeAttr(str) {
+    return String(str).replace(/"/g, '&quot;');
+}

package/bin/cli.js

@@ -0,0 +1,334 @@
+#!/usr/bin/env node
+/**
+ * Domma CMS — Project Scaffolder
+ * Usage: npx domma-cms <project-name> [--no-install] [--no-setup] [--seed]
+ */
+
+import {cpSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync} from 'node:fs';
+import {spawnSync} from 'node:child_process';
+import path from 'node:path';
+import {fileURLToPath} from 'node:url';
+
+// ---------------------------------------------------------------------------
+// Paths
+// ---------------------------------------------------------------------------
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+
+// ---------------------------------------------------------------------------
+// Node version check
+// ---------------------------------------------------------------------------
+
+const [major] = process.versions.node.split('.').map(Number);
+if (major < 18) {
+  console.error('\n  ✗ Domma CMS requires Node.js 18 or higher.\n');
+  process.exit(1);
+}
+
+// ---------------------------------------------------------------------------
+// Arg parsing
+// ---------------------------------------------------------------------------
+
+const args = process.argv.slice(2);
+const flags = new Set(args.filter(a => a.startsWith('--')));
+const positional = args.filter(a => !a.startsWith('--'));
+
+if (flags.has('--help') || args.includes('-h')) {
+  console.log(`
+  Usage: npx domma-cms <project-name> [options]
+
+  Options:
+    --no-install   Skip npm install
+    --no-setup     Skip the interactive setup wizard
+    --seed         Run npm run seed after setup
+    --help         Show this help message
+
+  Example:
+    npx domma-cms my-blog
+    npx domma-cms my-blog --no-install --no-setup
+`);
+  process.exit(0);
+}
+
+const projectName = positional[0];
+
+if (!projectName) {
+  console.error('\n  ✗ Project name is required.\n');
+  console.error('  Usage: npx domma-cms <project-name>\n');
+  process.exit(1);
+}
+
+// ---------------------------------------------------------------------------
+// Validation
+// ---------------------------------------------------------------------------
+
+if (!/^[a-z0-9._-]+$/i.test(projectName)) {
+  console.error(`\n  ✗ Invalid project name "${projectName}".`);
+  console.error('  Use only lowercase letters, numbers, hyphens, dots, or underscores.\n');
+  process.exit(1);
+}
+
+const target = path.resolve(process.cwd(), projectName);
+
+if (existsSync(target)) {
+  const contents = readdirSync(target);
+  if (contents.length > 0) {
+    console.error(`\n  ✗ Directory "${projectName}" already exists and is not empty.\n`);
+    process.exit(1);
+  }
+}
+
+const noInstall = flags.has('--no-install');
+const noSetup = flags.has('--no-setup') || noInstall;
+const withSeed = flags.has('--seed');
+
+// ---------------------------------------------------------------------------
+// Banner
+// ---------------------------------------------------------------------------
+
+console.log('');
+console.log('  ┌──────────────────────────────────────────┐');
+console.log('  │                                          │');
+console.log('  │   Domma CMS — Project Scaffolder        │');
+console.log('  │                                          │');
+console.log('  └──────────────────────────────────────────┘');
+console.log('');
+console.log(`  Creating project: ${projectName}`);
+console.log(`  Target:           ${target}`);
+console.log('');
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function step(label) {
+  process.stdout.write(`  ${label}…`);
+}
+
+function done() {
+  console.log(' done.');
+}
+
+function copyDir(src, dest) {
+  cpSync(path.join(PACKAGE_ROOT, src), path.join(target, dest ?? src), {recursive: true});
+}
+
+// ---------------------------------------------------------------------------
+// Create project structure
+// ---------------------------------------------------------------------------
+
+step('Creating directory');
+mkdirSync(target, {recursive: true});
+done();
+
+step('Copying server');
+copyDir('server');
+done();
+
+step('Copying admin');
+copyDir('admin');
+done();
+
+step('Copying public');
+copyDir('public');
+done();
+
+step('Copying scripts');
+copyDir('scripts');
+done();
+
+step('Copying config');
+copyDir('config');
+done();
+
+step('Copying plugins');
+copyDir('plugins');
+done();
+
+// ---------------------------------------------------------------------------
+// Reset data files inside copied plugins
+// ---------------------------------------------------------------------------
+
+step('Resetting plugin data');
+writeFileSync(path.join(target, 'plugins/example-analytics/stats.json'), '{}\n', 'utf8');
+writeFileSync(path.join(target, 'plugins/form-builder/data/submissions/contact.json'), '[]\n', 'utf8');
+done();
+
+// ---------------------------------------------------------------------------
+// Reset config to clean defaults
+// ---------------------------------------------------------------------------
+
+const DEFAULT_SITE = {
+  title: 'My Site',
+  tagline: 'Powered by Domma CMS',
+  theme: 'charcoal-dark',
+  seo: {
+    defaultTitle: 'My Site',
+    titleSeparator: ' | ',
+    defaultDescription: 'A site built with Domma CMS'
+  },
+  footer: {
+    copyright: `© ${new Date().getFullYear()} My Site. All rights reserved.`,
+    links: [
+      {text: 'Privacy Policy', url: '/privacy'},
+      {text: 'Contact', url: '/contact'}
+    ]
+  }
+};
+
+const DEFAULT_NAV = {
+  brand: {text: 'My Site', logo: null, url: '/'},
+  items: [
+    {text: 'Home', url: '/', icon: 'home'},
+    {text: 'About', url: '/about', icon: 'info'},
+    {text: 'Contact', url: '/contact', icon: 'mail'}
+  ],
+  variant: 'dark',
+  position: 'sticky'
+};
+
+// All plugins present but disabled by default in a fresh project
+const DEFAULT_PLUGINS = {
+  'example-analytics': {enabled: false, settings: {}},
+  'contact-form': {enabled: false, settings: {}},
+  'form-builder': {enabled: false, settings: {}},
+  'back-to-top': {enabled: false, settings: {}},
+  'cookie-consent': {enabled: false, settings: {}}
+};
+
+step('Writing default config');
+writeFileSync(path.join(target, 'config/site.json'), JSON.stringify(DEFAULT_SITE, null, 4) + '\n', 'utf8');
+writeFileSync(path.join(target, 'config/navigation.json'), JSON.stringify(DEFAULT_NAV, null, 4) + '\n', 'utf8');
+writeFileSync(path.join(target, 'config/plugins.json'), JSON.stringify(DEFAULT_PLUGINS, null, 4) + '\n', 'utf8');
+done();
+
+// ---------------------------------------------------------------------------
+// Create empty content directories
+// ---------------------------------------------------------------------------
+
+step('Creating content directories');
+mkdirSync(path.join(target, 'content/pages'), {recursive: true});
+mkdirSync(path.join(target, 'content/media'), {recursive: true});
+mkdirSync(path.join(target, 'content/users'), {recursive: true});
+done();
+
+// ---------------------------------------------------------------------------
+// Write project package.json (runtime deps only, private: true)
+// ---------------------------------------------------------------------------
+
+step('Writing package.json');
+const sourcePkg = JSON.parse(readFileSync(path.join(PACKAGE_ROOT, 'package.json'), 'utf8'));
+const projectPkg = {
+  name: projectName,
+  version: '0.1.0',
+  description: `${projectName} — powered by Domma CMS`,
+  type: 'module',
+  private: true,
+  main: 'server/server.js',
+  scripts: sourcePkg.scripts,
+  dependencies: sourcePkg.dependencies
+};
+writeFileSync(path.join(target, 'package.json'), JSON.stringify(projectPkg, null, 2) + '\n', 'utf8');
+done();
+
+// ---------------------------------------------------------------------------
+// Write .env.example and .env
+// ---------------------------------------------------------------------------
+
+const ENV_EXAMPLE = `# Domma CMS — Environment Variables
+# Auto-generated by the setup wizard (npm run setup)
+
+JWT_SECRET=CHANGE_ME
+NODE_ENV=development
+`;
+
+step('Writing .env files');
+writeFileSync(path.join(target, '.env.example'), ENV_EXAMPLE, 'utf8');
+writeFileSync(path.join(target, '.env'), ENV_EXAMPLE, 'utf8');
+done();
+
+// ---------------------------------------------------------------------------
+// Write .gitignore
+// ---------------------------------------------------------------------------
+
+const GITIGNORE = `node_modules/
+.env
+content/users/
+content/media/
+*.log
+`;
+
+step('Writing .gitignore');
+writeFileSync(path.join(target, '.gitignore'), GITIGNORE, 'utf8');
+done();
+
+// ---------------------------------------------------------------------------
+// npm install
+// ---------------------------------------------------------------------------
+
+console.log('');
+
+if (noInstall) {
+  console.log('  ⚠  Skipping npm install (--no-install).');
+} else {
+  console.log('  Running npm install…');
+  console.log('');
+  const result = spawnSync('npm', ['install'], {cwd: target, stdio: 'inherit'});
+  if (result.status !== 0) {
+    console.error('\n  ✗ npm install failed.\n');
+    process.exit(result.status ?? 1);
+  }
+  console.log('');
+}
+
+// ---------------------------------------------------------------------------
+// Setup wizard
+// ---------------------------------------------------------------------------
+
+if (noSetup) {
+  if (!noInstall) console.log('  ⚠  Skipping setup wizard (--no-setup).');
+} else {
+  console.log('  Running setup wizard (npm run setup)…');
+  console.log('');
+  const result = spawnSync(process.execPath, ['scripts/setup.js'], {cwd: target, stdio: 'inherit'});
+  if (result.status !== 0) {
+    console.error('\n  ✗ Setup failed.\n');
+    process.exit(result.status ?? 1);
+  }
+  console.log('');
+}
+
+// ---------------------------------------------------------------------------
+// Optional seed
+// ---------------------------------------------------------------------------
+
+if (withSeed) {
+  console.log('  Running seed (npm run seed)…');
+  console.log('');
+  const result = spawnSync('npm', ['run', 'seed'], {cwd: target, stdio: 'inherit'});
+  if (result.status !== 0) {
+    console.error('\n  ✗ Seed failed.\n');
+    process.exit(result.status ?? 1);
+  }
+  console.log('');
+}
+
+// ---------------------------------------------------------------------------
+// Success
+// ---------------------------------------------------------------------------
+
+console.log('');
+console.log('  ┌──────────────────────────────────────────┐');
+console.log('  │   ✓ Project created successfully!        │');
+console.log('  └──────────────────────────────────────────┘');
+console.log('');
+console.log(`  Next steps:`);
+console.log(`    cd ${projectName}`);
+if (noInstall) console.log(`    npm install`);
+if (noSetup) console.log(`    npm run setup`);
+console.log(`    npm run dev`);
+console.log('');
+console.log(`  Then open: http://localhost:3050/admin`);
+console.log('');

package/config/auth.json

@@ -0,0 +1,20 @@
+{
+    "accessTokenExpiry": "15m",
+    "refreshTokenExpiry": "7d",
+    "bcryptRounds": 10,
+    "roles": {
+        "admin":      { "label": "Admin",      "level": 0 },
+        "manager":    { "label": "Manager",    "level": 1 },
+        "editor":     { "label": "Editor",     "level": 2 },
+        "subscriber": { "label": "Subscriber", "level": 3 }
+    },
+    "permissions": {
+        "pages":      ["admin", "manager", "editor"],
+        "settings":   ["admin", "manager"],
+        "navigation": ["admin", "manager"],
+        "layouts":    ["admin", "manager"],
+        "media":      ["admin", "manager", "editor"],
+        "users":      ["admin", "manager"],
+        "plugins":    ["admin"]
+    }
+}

package/config/content.json

@@ -0,0 +1,10 @@
+{
+    "contentDir": "./content",
+    "mediaDir": "./content/media",
+    "usersDir": "./content/users",
+    "pageDefaults": {
+        "layout": "default",
+        "status": "draft",
+        "sortOrder": 99
+    }
+}

package/config/navigation.json

@@ -0,0 +1,63 @@
+{
+  "brand": {
+    "text": "My Site",
+    "logo": null,
+    "url": "/"
+  },
+  "items": [
+    {
+      "text": "Home",
+      "url": "/",
+      "icon": "home"
+    },
+    {
+      "text": "About",
+      "url": "/about",
+      "icon": "info"
+    },
+    {
+      "text": "Blog",
+      "url": "/blog",
+      "icon": "book-open"
+    },
+    {
+      "text": "Contact",
+      "url": "/contact",
+      "icon": "mail"
+    },
+    {
+      "text": "Resources",
+      "url": "/resources",
+      "icon": "book-open",
+      "items": [
+        {
+          "text": "Overview",
+          "url": "/resources",
+          "icon": "grid"
+        },
+        {
+          "text": "Typography",
+          "url": "/resources/typography",
+          "icon": "type"
+        },
+        {
+          "text": "Grid System",
+          "url": "/resources/grid",
+          "icon": "layout"
+        },
+        {
+          "text": "Cards",
+          "url": "/resources/cards",
+          "icon": "credit-card"
+        },
+        {
+          "text": "Shortcode Reference",
+          "url": "/resources/shortcodes",
+          "icon": "code"
+        }
+      ]
+    }
+  ],
+  "variant": "dark",
+  "position": "sticky"
+}