splent-feature-contact 0.1.0__tar.gz

splent_feature_contact-0.1.0/MANIFEST.in

@@ -0,0 +1,8 @@
+# Compiled frontend bundles
+recursive-include src/splent_io/splent_feature_contact/assets/dist *.js *.css *.map
+
+# Jinja templates (feature views + hook fragments)
+recursive-include src/splent_io/splent_feature_contact/templates *.html
+
+# Alembic migration config and scripts
+recursive-include src/splent_io/splent_feature_contact/migrations *.py *.ini *.mako

splent_feature_contact-0.1.0/PKG-INFO

@@ -0,0 +1,5 @@
+Metadata-Version: 2.4
+Name: splent_feature_contact
+Version: 0.1.0
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown

splent_feature_contact-0.1.0/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["setuptools>=80.3.1", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "splent_feature_contact"
+version = "0.1.0"
+readme = "README.md"
+requires-python = ">=3.13"
+
+dependencies = [
+
+]
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+exclude = ["*.tests", "*.tests.*"]
+
+[tool.splent]
+cli_version = "1.11.0"
+
+# ── Feature Contract (auto-generated) ────────────────────────────────────────
+# Do not edit manually — re-run `splent feature:contract --write` to refresh.
+[tool.splent.contract]
+description = "contact feature"
+
+[tool.splent.contract.provides]
+routes     = ["/admin/contact", "/admin/contact/<int:message_id>/delete", "/admin/contact/<int:message_id>/read", "/contact"]
+blueprints = []
+models     = ["ContactMessage"]
+commands   = ["hello"]
+hooks      = ["layout.authenticated_sidebar"]
+services   = ["ContactService"]
+signals    = ["contact-created", "contact-submitting"]
+translations = []
+docker     = []
+
+[tool.splent.contract.requires]
+features = []
+env_vars = []
+signals  = []
+
+[tool.splent.contract.extensible]
+services  = ["ContactService"]
+templates = ["contact/admin/list.html", "contact/index.html"]
+models    = ["ContactMessage"]
+hooks     = ["layout.authenticated_sidebar"]
+routes    = false

splent_feature_contact-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

splent_feature_contact-0.1.0/src/splent_feature_contact.egg-info/PKG-INFO

@@ -0,0 +1,5 @@
+Metadata-Version: 2.4
+Name: splent_feature_contact
+Version: 0.1.0
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown

splent_feature_contact-0.1.0/src/splent_feature_contact.egg-info/SOURCES.txt

@@ -0,0 +1,25 @@
+MANIFEST.in
+pyproject.toml
+src/splent_feature_contact.egg-info/PKG-INFO
+src/splent_feature_contact.egg-info/SOURCES.txt
+src/splent_feature_contact.egg-info/dependency_links.txt
+src/splent_feature_contact.egg-info/top_level.txt
+src/splent_io/splent_feature_contact/__init__.py
+src/splent_io/splent_feature_contact/commands.py
+src/splent_io/splent_feature_contact/config.py
+src/splent_io/splent_feature_contact/forms.py
+src/splent_io/splent_feature_contact/hooks.py
+src/splent_io/splent_feature_contact/models.py
+src/splent_io/splent_feature_contact/repositories.py
+src/splent_io/splent_feature_contact/routes.py
+src/splent_io/splent_feature_contact/seeders.py
+src/splent_io/splent_feature_contact/services.py
+src/splent_io/splent_feature_contact/signals.py
+src/splent_io/splent_feature_contact/assets/dist/splent_feature_contact.bundle.js
+src/splent_io/splent_feature_contact/assets/dist/splent_feature_contact.bundle.js.map
+src/splent_io/splent_feature_contact/migrations/alembic.ini
+src/splent_io/splent_feature_contact/migrations/env.py
+src/splent_io/splent_feature_contact/migrations/script.py.mako
+src/splent_io/splent_feature_contact/migrations/versions/contact0001_initial.py
+src/splent_io/splent_feature_contact/templates/contact/index.html
+src/splent_io/splent_feature_contact/templates/contact/admin/list.html

splent_feature_contact-0.1.0/src/splent_feature_contact.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

splent_feature_contact-0.1.0/src/splent_feature_contact.egg-info/top_level.txt

@@ -0,0 +1 @@
+splent_io

splent_feature_contact-0.1.0/src/splent_io/splent_feature_contact/__init__.py

@@ -0,0 +1,50 @@
+from splent_framework.blueprints.base_blueprint import create_blueprint
+from splent_framework.nav.nav_registry import register_nav_item
+from splent_framework.services.service_locator import register_service
+
+from splent_io.splent_feature_contact.services import ContactService
+
+contact_bp = create_blueprint(__name__)
+
+
+def init_feature(app):
+    from splent_framework.assets.asset_registry import register_asset
+    from splent_framework.settings.settings_schema import register_settings
+
+    register_service(app, "ContactService", ContactService)
+
+    # Public contact-form styles, shipped through the asset registry (never
+    # inline / CDN) from the feature's OWN assets/css/contact.css.
+    register_asset(
+        "css", "contact.assets", order=100, subfolder="css", filename="contact.css"
+    )
+
+    # Public main-nav entry; surfaces only when the feature is selected.
+    register_nav_item(key="contact", label="Contact", href="/contact", order=60)
+
+    # Declarative admin settings — the framework renders the panel and persists
+    # the values; routes read them via get_config("contact").
+    register_settings(
+        "contact",
+        "Contact",
+        [
+            {
+                "key": "recipient",
+                "type": "text",
+                "default": "",
+                "label": "Recipient email",
+                "help": "Where contact messages are sent.",
+            },
+            {
+                "key": "success_message",
+                "type": "text",
+                "default": "Thanks — we'll be in touch.",
+                "label": "Success message",
+            },
+        ],
+        icon="mail",
+    )
+
+
+def inject_context_vars(app):
+    return {}

splent_feature_contact-0.1.0/src/splent_io/splent_feature_contact/assets/dist/splent_feature_contact.bundle.js

@@ -0,0 +1,20 @@
+/******/ (() => { // webpackBootstrap
+/*!*******************************************************************************************!*\
+  !*** ../splent_feature_contact/src/splent_io/splent_feature_contact/assets/js/scripts.js ***!
+  \*******************************************************************************************/
+// Entry point for splent_feature_contact frontend assets.
+// Add your JavaScript here. Webpack compiles this into assets/dist/splent_feature_contact.bundle.js
+//
+// To load the compiled bundle in the product layout, register it in hooks.py:
+//
+//   from splent_framework.hooks.template_hooks import register_template_hook
+//   from flask import url_for
+//
+//   def contact_scripts():
+//       return '<script src="' + url_for("contact.assets", subfolder="dist", filename="splent_feature_contact.bundle.js") + '"></script>'
+//
+//   register_template_hook("layout.scripts", contact_scripts)
+
+/******/ })()
+;
+//# sourceMappingURL=splent_feature_contact.bundle.js.map

splent_feature_contact-0.1.0/src/splent_io/splent_feature_contact/assets/dist/splent_feature_contact.bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"splent_feature_contact.bundle.js","mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA","sources":["webpack://diversolab_app/../splent_feature_contact/src/splent_io/splent_feature_contact/assets/js/scripts.js"],"sourcesContent":["// Entry point for splent_feature_contact frontend assets.\n// Add your JavaScript here. Webpack compiles this into assets/dist/splent_feature_contact.bundle.js\n//\n// To load the compiled bundle in the product layout, register it in hooks.py:\n//\n//   from splent_framework.hooks.template_hooks import register_template_hook\n//   from flask import url_for\n//\n//   def contact_scripts():\n//       return '<script src=\"' + url_for(\"contact.assets\", subfolder=\"dist\", filename=\"splent_feature_contact.bundle.js\") + '\"></script>'\n//\n//   register_template_hook(\"layout.scripts\", contact_scripts)\n"],"names":[],"sourceRoot":""}

splent_feature_contact-0.1.0/src/splent_io/splent_feature_contact/commands.py

@@ -0,0 +1,21 @@
+"""
+CLI commands contributed by splent_feature_contact.
+
+These commands are auto-discovered by the framework and exposed in the
+SPLENT CLI under the ``feature:contact`` group.
+
+Usage::
+
+    splent feature:contact hello
+"""
+
+import click
+
+
+@click.command("hello")
+def hello():
+    """Example command — replace with your own."""
+    click.echo("  Hello from splent_feature_contact!")
+
+
+cli_commands = [hello]

splent_feature_contact-0.1.0/src/splent_io/splent_feature_contact/config.py

@@ -0,0 +1,19 @@
+"""
+contact feature configuration.
+
+Injects environment variables into Flask app.config.
+Add your feature's env vars here so the framework can track them.
+
+To regenerate from source code: splent feature:inject-config splent_feature_contact
+"""
+
+import os  # noqa: F401 — used when adding env vars below
+
+
+def inject_config(app):
+    app.config.update(
+        {
+            # Add your feature's env vars here, e.g.:
+            # "MY_VAR": os.getenv("MY_VAR", "default_value"),
+        }
+    )

splent_feature_contact-0.1.0/src/splent_io/splent_feature_contact/forms.py

@@ -0,0 +1,6 @@
+from flask_wtf import FlaskForm
+from wtforms import SubmitField
+
+
+class SplentFeatureContactForm(FlaskForm):
+    submit = SubmitField("Save splent_feature_contact")

splent_feature_contact-0.1.0/src/splent_io/splent_feature_contact/hooks.py

@@ -0,0 +1,34 @@
+"""Template hooks for splent_feature_contact.
+
+Adds an admin "Contact" link to the authenticated sidebar, with a badge showing
+how many messages are still unread. The public "Contact" nav entry is declared
+via register_nav_item() in __init__.py, not here.
+"""
+
+from flask import request, url_for
+
+from splent_framework.hooks.template_hooks import register_template_hook
+from splent_framework.services.service_locator import service_proxy
+
+
+def contact_admin_link():
+    active = (
+        "active"
+        if request.endpoint and request.endpoint.startswith("contact.admin")
+        else ""
+    )
+    pending = 0
+    try:
+        pending = service_proxy("ContactService").pending_count()
+    except Exception:
+        pass
+    badge = f' <span class="badge bg-danger">{pending}</span>' if pending else ""
+    return (
+        f'<li class="sidebar-item {active}">'
+        f'<a class="sidebar-link" href="{url_for("contact.admin_index")}">'
+        '<i class="align-middle" data-feather="mail"></i> '
+        f'<span class="align-middle">Contact</span>{badge}</a></li>'
+    )
+
+
+register_template_hook("layout.authenticated_sidebar", contact_admin_link)

splent_feature_contact-0.1.0/src/splent_io/splent_feature_contact/migrations/alembic.ini

@@ -0,0 +1,36 @@
+[alembic]
+script_location = migrations
+
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARN
+handlers = console
+qualname =
+
+[logger_sqlalchemy]
+level = WARN
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers =
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s [%(name)s] %(message)s
+datefmt = %H:%M:%S

splent_feature_contact-0.1.0/src/splent_io/splent_feature_contact/migrations/env.py

@@ -0,0 +1,9 @@
+"""Alembic migration environment for splent_feature_contact."""
+
+from splent_io.splent_feature_contact import models  # noqa
+from splent_framework.migrations.feature_env import run_feature_migrations
+
+FEATURE_NAME = "splent_feature_contact"
+FEATURE_TABLES = set()
+
+run_feature_migrations(FEATURE_NAME, FEATURE_TABLES)

splent_feature_contact-0.1.0/src/splent_io/splent_feature_contact/migrations/script.py.mako

@@ -0,0 +1,24 @@
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+
+"""
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+# revision identifiers, used by Alembic.
+revision = ${repr(up_revision)}
+down_revision = ${repr(down_revision)}
+branch_labels = ${repr(branch_labels)}
+depends_on = ${repr(depends_on)}
+
+
+def upgrade():
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade():
+    ${downgrades if downgrades else "pass"}

splent_feature_contact-0.1.0/src/splent_io/splent_feature_contact/migrations/versions/contact0001_initial.py

@@ -0,0 +1,35 @@
+"""contact_message table.
+
+Revision ID: contact0001
+Revises:
+"""
+
+import sqlalchemy as sa
+from alembic import op
+
+revision = "contact0001"
+down_revision = None
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    op.create_table(
+        "contact_message",
+        sa.Column("id", sa.Integer(), nullable=False),
+        sa.Column("name", sa.String(length=255), nullable=False),
+        sa.Column("email", sa.String(length=255), nullable=False),
+        sa.Column("subject", sa.String(length=255), nullable=True),
+        sa.Column("message", sa.Text(), nullable=False),
+        sa.Column("created_at", sa.DateTime(), nullable=True),
+        sa.Column("read", sa.Boolean(), nullable=True),
+        sa.PrimaryKeyConstraint("id"),
+    )
+    op.create_index(
+        op.f("ix_contact_message_read"), "contact_message", ["read"], unique=False
+    )
+
+
+def downgrade():
+    op.drop_index(op.f("ix_contact_message_read"), table_name="contact_message")
+    op.drop_table("contact_message")

splent_feature_contact-0.1.0/src/splent_io/splent_feature_contact/models.py

@@ -0,0 +1,24 @@
+from datetime import datetime
+
+from splent_framework.db import db
+
+
+class ContactMessage(db.Model):
+    """A message submitted through the public contact form.
+
+    Stored even when the notification email fails to send, so nothing is lost.
+    ``read`` flags whether an admin has triaged it.
+    """
+
+    __tablename__ = "contact_message"
+
+    id = db.Column(db.Integer, primary_key=True)
+    name = db.Column(db.String(255), nullable=False)
+    email = db.Column(db.String(255), nullable=False)
+    subject = db.Column(db.String(255), default="")
+    message = db.Column(db.Text, nullable=False)
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+    read = db.Column(db.Boolean, default=False, index=True)
+
+    def __repr__(self):
+        return f"ContactMessage<{self.id} from {self.email}>"

splent_feature_contact-0.1.0/src/splent_io/splent_feature_contact/repositories.py

@@ -0,0 +1,17 @@
+from splent_io.splent_feature_contact.models import ContactMessage
+from splent_framework.repositories.BaseRepository import BaseRepository
+
+
+class ContactRepository(BaseRepository):
+    def __init__(self):
+        super().__init__(ContactMessage)
+
+    def all_newest_first(self) -> list[ContactMessage]:
+        return ContactMessage.query.order_by(ContactMessage.created_at.desc()).all()
+
+    def pending(self) -> list[ContactMessage]:
+        return (
+            ContactMessage.query.filter_by(read=False)
+            .order_by(ContactMessage.created_at.desc())
+            .all()
+        )

splent_feature_contact-0.1.0/src/splent_io/splent_feature_contact/routes.py

@@ -0,0 +1,100 @@
+from flask import flash, redirect, render_template, request, url_for
+from flask_login import login_required
+
+from splent_io.splent_feature_contact import contact_bp
+from splent_io.splent_feature_contact.signals import (
+    contact_created,
+    contact_submitting,
+)
+from splent_framework.services.service_locator import service_proxy
+from splent_framework.settings.settings_schema import get_config
+
+contact_service = service_proxy("ContactService")
+
+
+# =====================================================================
+# PUBLIC — the contact form
+# =====================================================================
+@contact_bp.route("/contact", methods=["GET", "POST"])
+def index():
+    if request.method == "GET":
+        return render_template("contact/index.html")
+
+    # Let any listener (a captcha provider, a spam filter…) veto the submission.
+    # contact knows nothing about captchas — they connect to this signal.
+    results = contact_submitting.send(
+        None, form=request.form, remoteip=request.remote_addr
+    )
+    if any(value is False for _, value in results):
+        flash("Spam check failed — please try again.", "danger")
+        return redirect(url_for("contact.index"))
+
+    name = (request.form.get("name") or "").strip()
+    email = (request.form.get("email") or "").strip()
+    subject = (request.form.get("subject") or "").strip()
+    message = (request.form.get("message") or "").strip()
+
+    if not (name and email and message):
+        flash("Name, email and message are required.", "danger")
+        return redirect(url_for("contact.index"))
+
+    contact_message = contact_service.create_message(
+        name=name, email=email, subject=subject, message=message
+    )
+
+    # Notify the configured recipient. The message is already saved, so a mail
+    # failure must not lose it — wrap in try/except and still flash success.
+    mail = service_proxy("MailService")
+    recipient = get_config("contact").get("recipient") or ""
+    if not recipient:
+        try:
+            recipient = mail.from_address()
+        except Exception:
+            recipient = None
+
+    body = f"Name: {name}\nEmail: {email}\nSubject: {subject}\n\n{message}\n"
+    if recipient:
+        try:
+            mail.send(
+                to=recipient,
+                subject="[Contact] " + (subject or "(no subject)"),
+                body=body,
+                reply_to=email,
+            )
+        except Exception:
+            pass
+
+    contact_created.send(None, message=contact_message)
+
+    success = get_config("contact").get("success_message") or (
+        "Thanks — we'll be in touch."
+    )
+    flash(success, "success")
+    return redirect(url_for("contact.index"))
+
+
+# =====================================================================
+# ADMIN — inbox
+# =====================================================================
+@contact_bp.route("/admin/contact", methods=["GET"])
+@login_required
+def admin_index():
+    return render_template(
+        "contact/admin/list.html", messages=contact_service.all_messages()
+    )
+
+
+@contact_bp.route("/admin/contact/<int:message_id>/read", methods=["POST"])
+@login_required
+def admin_read(message_id):
+    contact_service.mark_read(message_id)
+    flash("Message marked as read.", "success")
+    return redirect(url_for("contact.admin_index"))
+
+
+@contact_bp.route("/admin/contact/<int:message_id>/delete", methods=["POST"])
+@login_required
+def admin_delete(message_id):
+    contact_service.delete_message(message_id)
+    flash("Message deleted.", "success")
+    return redirect(url_for("contact.admin_index"))

splent_feature_contact-0.1.0/src/splent_io/splent_feature_contact/seeders.py

@@ -0,0 +1,10 @@
+from splent_framework.seeders.BaseSeeder import BaseSeeder
+
+
+class SplentFeatureContactSeeder(BaseSeeder):
+    def run(self):
+        data = [
+            # Create any Model object you want to make seed
+        ]
+
+        self.seed(data)

splent_feature_contact-0.1.0/src/splent_io/splent_feature_contact/services.py

@@ -0,0 +1,34 @@
+from splent_io.splent_feature_contact.models import ContactMessage
+from splent_io.splent_feature_contact.repositories import ContactRepository
+from splent_framework.services.BaseService import BaseService
+
+
+class ContactService(BaseService):
+    def __init__(self):
+        super().__init__(ContactRepository())
+
+    def all_messages(self):
+        """Every message, newest first."""
+        return self.repository.all_newest_first()
+
+    def pending_count(self) -> int:
+        """How many messages are still unread (for the sidebar badge)."""
+        return ContactMessage.query.filter_by(read=False).count()
+
+    def create_message(self, name, email, subject, message):
+        """Persist a submitted contact message and return it."""
+        return self.repository.create(
+            name=name,
+            email=email,
+            subject=subject or "",
+            message=message,
+            read=False,
+        )
+
+    def mark_read(self, message_id):
+        """Flag a message as read."""
+        return self.repository.update(message_id, read=True)
+
+    def delete_message(self, message_id):
+        """Remove a message permanently."""
+        return self.repository.delete(message_id)

splent_feature_contact-0.1.0/src/splent_io/splent_feature_contact/signals.py

@@ -0,0 +1,12 @@
+"""Signals emitted by the contact feature.
+
+contact stays decoupled from anti-spam: it emits ``contact-submitting`` and any
+listener (a captcha provider, a spam filter…) may return False to veto the
+submission — mirroring comments' ``comment-submitting``. ``contact-created``
+fires after a message is stored, for things like notifications or counters.
+"""
+
+from splent_framework.signals.signal_utils import define_signal
+
+contact_submitting = define_signal("contact-submitting", "splent_feature_contact")
+contact_created = define_signal("contact-created", "splent_feature_contact")

splent_feature_contact-0.1.0/src/splent_io/splent_feature_contact/templates/contact/admin/list.html

@@ -0,0 +1,92 @@
+{% extends "base_template.html" %}
+
+{% block title %}{{ _('Contact') }}{% endblock %}
+
+{% block content %}
+<div class="container section">
+
+  <header class="page-header">
+    <h1>{{ _('Contact') }}</h1>
+    <p class="text-muted">{{ _('Messages submitted through the contact form.') }}</p>
+  </header>
+
+  {# Flash messages #}
+  {% with messages = get_flashed_messages(with_categories=true) %}
+    {% if messages %}
+      <div class="admin-flashes">
+        {% for category, message in messages %}
+          <div class="alert alert-{{ category }}">{{ message }}</div>
+        {% endfor %}
+      </div>
+    {% endif %}
+  {% endwith %}
+
+  <table class="table">
+    <thead>
+      <tr>
+        <th>{{ _('From') }}</th>
+        <th>{{ _('Subject') }}</th>
+        <th>{{ _('Message') }}</th>
+        <th>{{ _('Date') }}</th>
+        <th>{{ _('Status') }}</th>
+        <th>{{ _('Actions') }}</th>
+      </tr>
+    </thead>
+    <tbody>
+      {% for m in messages %}
+        <tr class="{{ '' if m.read else 'table-active' }}">
+          <td>
+            <strong>{{ m.name }}</strong>
+            <br><span class="text-muted">{{ m.email }}</span>
+          </td>
+          <td>{{ m.subject or '—' }}</td>
+          <td>{{ m.message|truncate(100, true) }}</td>
+          <td>{{ m.created_at.strftime('%Y-%m-%d %H:%M') }}</td>
+          <td>
+            {% if m.read %}
+              <span class="badge bg-secondary">{{ _('read') }}</span>
+            {% else %}
+              <span class="badge bg-warning text-dark">{{ _('unread') }}</span>
+            {% endif %}
+          </td>
+          <td class="contact-actions">
+            {% if not m.read %}
+              <form method="POST"
+                    action="{{ url_for('contact.admin_read', message_id=m.id) }}"
+                    class="d-inline">
+                <button type="submit" class="btn btn-sm btn-success">
+                  {{ _('Mark read') }}
+                </button>
+              </form>
+            {% endif %}
+            <form method="POST"
+                  action="{{ url_for('contact.admin_delete', message_id=m.id) }}"
+                  class="d-inline"
+                  onsubmit="return confirm('{{ _('Delete this message?') }}');">
+              <button type="submit"
+                      class="btn btn-sm btn-danger"
+                      title="{{ _('Delete') }}"
+                      aria-label="{{ _('Delete') }}">
+                <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16"
+                     viewBox="0 0 24 24" fill="none" stroke="currentColor"
+                     stroke-width="2" stroke-linecap="round" stroke-linejoin="round"
+                     aria-hidden="true">
+                  <line x1="18" y1="6" x2="6" y2="18"></line>
+                  <line x1="6" y1="6" x2="18" y2="18"></line>
+                </svg>
+              </button>
+            </form>
+          </td>
+        </tr>
+      {% else %}
+        <tr>
+          <td colspan="6" class="text-muted text-center">
+            {{ _('No messages yet.') }}
+          </td>
+        </tr>
+      {% endfor %}
+    </tbody>
+  </table>
+
+</div>
+{% endblock %}

splent_feature_contact-0.1.0/src/splent_io/splent_feature_contact/templates/contact/index.html

@@ -0,0 +1,75 @@
+{% extends "public_base.html" %}
+
+{% block title %}{{ _('Contact') }} — {{ SPLENT_APP }}{% endblock %}
+
+{% block hero %}
+    {{ render_block('hero', eyebrow=_('Contact'), title=_('Get in touch'),
+                    subtitle=_('Send us a message and we will get back to you.')) }}
+{% endblock %}
+
+{% block content %}
+<div class="container section">
+
+  {# Flash messages #}
+  {% with messages = get_flashed_messages(with_categories=true) %}
+    {% if messages %}
+      <div class="contact-form__flashes">
+        {% for category, message in messages %}
+          <div class="alert alert-{{ category }}">{{ message }}</div>
+        {% endfor %}
+      </div>
+    {% endif %}
+  {% endwith %}
+
+  <form class="contact-form"
+        method="POST"
+        action="{{ url_for('contact.index') }}">
+
+    <div class="form-group">
+      <label for="contact-name">{{ _('Name') }}</label>
+      <input type="text"
+             id="contact-name"
+             name="name"
+             class="form-control"
+             required>
+    </div>
+
+    <div class="form-group">
+      <label for="contact-email">{{ _('Email') }}</label>
+      <input type="email"
+             id="contact-email"
+             name="email"
+             class="form-control"
+             required>
+    </div>
+
+    <div class="form-group">
+      <label for="contact-subject">{{ _('Subject') }}</label>
+      <input type="text"
+             id="contact-subject"
+             name="subject"
+             class="form-control">
+    </div>
+
+    <div class="form-group">
+      <label for="contact-message">{{ _('Message') }}</label>
+      <textarea id="contact-message"
+                name="message"
+                class="form-control"
+                rows="6"
+                required></textarea>
+    </div>
+
+    {# Captcha widget (cloudflare / recaptcha) — empty when none installed #}
+    {% if captcha_widget is defined %}
+      {{ captcha_script() }}
+      {{ captcha_widget() }}
+    {% endif %}
+
+    <button type="submit" class="btn btn-primary">
+      {{ _('Send message') }}
+    </button>
+  </form>
+
+</div>
+{% endblock %}