diff --git a/LICENSE b/LICENSE
index 4fdaf2a..cb069f5 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,21 +1,662 @@
-MIT License
+                    GNU AFFERO GENERAL PUBLIC LICENSE
+                       Version 3, 19 November 2007
 
-Copyright (c) 2026-present metamorphosis-dev
+ Copyright (C) 2026-present metamorphosis-dev
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
+                            Preamble
 
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+  The GNU Affero General Public License is a free, copyleft license for
+software and other kinds of works, specifically designed to ensure
+cooperation with the community in the case of network server software.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+our General Public Licenses are intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  Developers that use our General Public Licenses protect your rights
+with two steps: (1) assert copyright on the software, and (2) offer
+you this License which gives you legal permission to copy, distribute
+and/or modify the software.
+
+  A secondary benefit of defending all users' freedom is that
+improvements made in alternate versions of the program, if they
+receive widespread use, become available for other developers to
+incorporate.  Many developers of free software are heartened and
+encouraged by the resulting cooperation.  However, in the case of
+software used on network servers, this result may fail to come about.
+The GNU General Public License permits making a modified version and
+letting the public access it on a server without ever releasing its
+source code to the public.
+
+  The GNU Affero General Public License is designed specifically to
+ensure that, in such cases, the modified source code becomes available
+to the community.  It requires the operator of a network server to
+provide the source code of the modified version running there to the
+users of that server.  Therefore, public use of a modified version, on
+a publicly accessible server, gives the public access to the source
+code of the modified version.
+
+  An older license, called the Affero General Public License and
+published by Affero, was designed to accomplish similar goals.  This is
+a different license, not a version of the Affero GPL, but Affero has
+released a new version of the Affero GPL which permits relicensing under
+this license.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                       TERMS AND CONDITIONS
+
+  0. Definitions.
+
+  "This License" refers to version 3 of the GNU Affero General Public License.
+
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+  1. Source Code.
+
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+  The Corresponding Source for a work in source code form is that
+same work.
+
+  2. Basic Permissions.
+
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the Corresponding
+    Source from a network server at no charge.
+
+    c) Convey individual copies of the object code with a copy of the
+    written offer to provide the Corresponding Source.  This
+    alternative is allowed only occasionally and noncommercially, and
+    only if you received the object code with such an offer, in accord
+    with subsection 6b.
+
+    d) Convey the object code by offering access from a designated
+    place (gratis or for a charge), and offer equivalent access to the
+    Corresponding Source in the same way through the same place at no
+    further charge.  You need not require recipients to copy the
+    Corresponding Source along with the object code.  If the place to
+    copy the object code is a network server, the Corresponding Source
+    may be on a different server (operated by you or a third party)
+    that supports equivalent copying facilities, provided you maintain
+    clear directions next to the object code saying where to find the
+    Corresponding Source.  Regardless of what server hosts the
+    Corresponding Source, you remain obligated to ensure that it is
+    available for as long as needed to satisfy these requirements.
+
+    e) Convey the object code using peer-to-peer transmission, provided
+    you inform other peers where the object code and Corresponding
+    Source of the work are being offered to the general public at no
+    charge under subsection 6d.
+
+  A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+  A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+  "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+  If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+  The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+  Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+  7. Additional Terms.
+
+  "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+  When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+  Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+    a) Disclaiming warranty or limiting liability differently from the
+    terms of sections 15 and 16 of this License; or
+
+    b) Requiring preservation of specified reasonable legal notices or
+    author attributions in that material or in the Appropriate Legal
+    Notices displayed by works containing it; or
+
+    c) Prohibiting misrepresentation of the origin of that material, or
+    requiring that modified versions of such material be marked in
+    reasonable ways as different from the original version; or
+
+    d) Limiting the use for publicity purposes of names of licensors or
+    authors of the material; or
+
+    e) Declining to grant rights under trademark law for use of some
+    trade names, trademarks, or service marks; or
+
+    f) Requiring indemnification of licensors and authors of that
+    material by anyone who conveys the material (or modified versions of
+    it) with contractual assumptions of liability to the recipient, for
+    any liability that these contractual assumptions directly impose on
+    those licensors and authors.
+
+  All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+  If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+  Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+  8. Termination.
+
+  You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+  However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+  Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+  Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+  9. Acceptance Not Required for Having Copies.
+
+  You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+  10. Automatic Licensing of Downstream Recipients.
+
+  Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+  An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+  You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+  11. Patents.
+
+  A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+  A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+  In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+  If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+  If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+  A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+  Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+  12. No Surrender of Others' Freedom.
+
+  If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+  13. Remote Network Interaction; Use with the GNU General Public License.
+
+  Notwithstanding any other provision of this License, if you modify the
+Program, your modified version must prominently offer all users
+interacting with it remotely through a computer network (if your version
+supports such interaction) an opportunity to receive the Corresponding
+Source of your version by providing access to the Corresponding Source
+from a network server at no charge, through some standard or customary
+means of facilitating copying of software.  This Corresponding Source
+shall include the Corresponding Source for any work covered by version 3
+of the GNU General Public License that is incorporated pursuant to the
+following paragraph.
+
+  Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the work with which it is combined will remain governed by version
+3 of the GNU General Public License.
+
+  14. Revised Versions of this License.
+
+  The Free Software Foundation may publish revised and/or new versions of
+the GNU Affero General Public License from time to time.  Such new versions
+will be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+  Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU Affero General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU Affero General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+  If the Program specifies that a proxy can decide which future
+versions of the GNU Affero General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+  Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+  15. Disclaimer of Warranty.
+
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. Limitation of Liability.
+
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+  17. Interpretation of Sections 15 and 16.
+
+  If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    kafka — a privacy-respecting metasearch engine
+    Copyright (C) 2026-present metamorphosis-dev
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU Affero General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU Affero General Public License for more details.
+
+    You should have received a copy of the GNU Affero General Public License
+    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+  Also add information on how to contact you by electronic and paper mail.
+
+  If your software can interact with users remotely through a computer
+network, you should also make sure that it provides a way for users to
+get its source.  For example, if your program is a web application, its
+interface could display a "Source" link that leads users to an archive
+of the code.  There are many ways you could offer source, and different
+solutions will be better for different programs; see section 13 for the
+specific requirements.
+
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU AGPL, see
+<https://www.gnu.org/licenses/>.
diff --git a/cmd/kafka/main.go b/cmd/kafka/main.go
index 90c750d..cdc81b5 100644
--- a/cmd/kafka/main.go
+++ b/cmd/kafka/main.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package main
 
 import (
@@ -61,7 +77,7 @@ func main() {
 
 	acSvc := autocomplete.NewService(cfg.Upstream.URL, cfg.HTTPTimeout())
 
-	h := httpapi.NewHandler(svc, acSvc.Suggestions)
+	h := httpapi.NewHandler(svc, acSvc.Suggestions, cfg.Server.SourceURL)
 
 	mux := http.NewServeMux()
 	mux.HandleFunc("/", h.Index)
diff --git a/config.example.toml b/config.example.toml
index 34f60a6..042bb63 100644
--- a/config.example.toml
+++ b/config.example.toml
@@ -14,6 +14,11 @@ http_timeout = "10s"
 # Example: "https://search.example.com"
 base_url = ""
 
+# Link to the source code (shown in footer as "Source" link)
+# Defaults to the upstream kafka repo if not set.
+# Example: "https://git.example.com/my-kafka-fork"
+source_url = ""
+
 [upstream]
 # URL of an upstream metasearch instance for unported engines (env: UPSTREAM_SEARXNG_URL)
 # Leave empty to run without an upstream proxy.
diff --git a/internal/autocomplete/service.go b/internal/autocomplete/service.go
index 99d963a..23473d5 100644
--- a/internal/autocomplete/service.go
+++ b/internal/autocomplete/service.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package autocomplete
 
 import (
@@ -11,8 +27,7 @@ import (
 	"time"
 )
 
-// Service fetches search suggestions from an upstream metasearch instance
-// or falls back to Wikipedia's OpenSearch API.
+// Service fetches search suggestions from upstream or Wikipedia OpenSearch.
 type Service struct {
 	upstreamURL string
 	http       *http.Client
@@ -28,7 +43,6 @@ func NewService(upstreamURL string, timeout time.Duration) *Service {
 	}
 }
 
-// Suggestions returns search suggestions for the given query.
 func (s *Service) Suggestions(ctx context.Context, query string) ([]string, error) {
 	if strings.TrimSpace(query) == "" {
 		return nil, nil
@@ -40,7 +54,6 @@ func (s *Service) Suggestions(ctx context.Context, query string) ([]string, erro
 	return s.wikipediaSuggestions(ctx, query)
 }
 
-// upstreamSuggestions proxies to an upstream /autocompleter endpoint.
 func (s *Service) upstreamSuggestions(ctx context.Context, query string) ([]string, error) {
 	u := s.upstreamURL + "/autocompleter?" + url.Values{"q": {query}}.Encode()
 	req, err := http.NewRequestWithContext(ctx, http.MethodGet, u, nil)
diff --git a/internal/cache/cache.go b/internal/cache/cache.go
index b0099f9..78bd0ea 100644
--- a/internal/cache/cache.go
+++ b/internal/cache/cache.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package cache
 
 import (
diff --git a/internal/config/config.go b/internal/config/config.go
index 7f8b06a..e5d1fbb 100644
--- a/internal/config/config.go
+++ b/internal/config/config.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package config
 
 import (
@@ -24,7 +40,8 @@ type Config struct {
 type ServerConfig struct {
 	Port        int    `toml:"port"`
 	HTTPTimeout string `toml:"http_timeout"`
-	BaseURL     string `toml:"base_url"` // Public URL for OpenSearch XML (e.g. "https://search.example.com")
+	BaseURL     string `toml:"base_url"`  // Public URL for OpenSearch XML (e.g. "https://search.example.com")
+	SourceURL   string `toml:"source_url"` // Link to the source code (e.g. "https://git.example.com/fork/kafka")
 }
 
 type UpstreamConfig struct {
diff --git a/internal/contracts/main_result.go b/internal/contracts/main_result.go
index b5b568a..02fb29c 100644
--- a/internal/contracts/main_result.go
+++ b/internal/contracts/main_result.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package contracts
 
 import (
@@ -6,14 +22,10 @@ import (
 )
 
 // MainResult represents one element of the `results` array.
-//
-// The API returns many additional keys beyond what templates use. To keep the
-// contract stable for proxying/merging, we preserve all unknown keys in
-// `raw` and re-emit them via MarshalJSON.
+// Unknown keys are preserved in `raw` and re-emitted via MarshalJSON.
 type MainResult struct {
 	raw map[string]any
 
-	// Common fields used by templates (RSS uses: title, url, content, pubdate).
 	Template  string `json:"template"`
 	Title     string `json:"title"`
 	Content   string `json:"content"`
@@ -29,17 +41,13 @@ type MainResult struct {
 	Positions []int    `json:"positions"`
 	Engines   []string `json:"engines"`
 
-	// These fields exist in the MainResult base; keep them so downstream
-	// callers can generate richer output later.
 	OpenGroup  bool `json:"open_group"`
 	CloseGroup bool `json:"close_group"`
 
-	// parsed_url is emitted as a tuple; we preserve it as-is.
 	ParsedURL any `json:"parsed_url"`
 }
 
 func (mr *MainResult) UnmarshalJSON(data []byte) error {
-	// Preserve the full object.
 	dec := json.NewDecoder(bytes.NewReader(data))
 	dec.UseNumber()
 
@@ -50,7 +58,6 @@ func (mr *MainResult) UnmarshalJSON(data []byte) error {
 
 	mr.raw = m
 
-	// Fill the typed/common fields (best-effort; don't fail if types differ).
 	mr.Template = stringOrEmpty(m["template"])
 	mr.Title = stringOrEmpty(m["title"])
 	mr.Content = stringOrEmpty(m["content"])
@@ -88,12 +95,10 @@ func (mr *MainResult) UnmarshalJSON(data []byte) error {
 }
 
 func (mr MainResult) MarshalJSON() ([]byte, error) {
-	// If we came from upstream JSON, preserve all keys exactly.
 	if mr.raw != nil {
 		return json.Marshal(mr.raw)
 	}
 
-	// Otherwise, marshal the known fields.
 	m := map[string]any{
 		"template":  mr.Template,
 		"title":     mr.Title,
diff --git a/internal/contracts/types.go b/internal/contracts/types.go
index 81103ce..40ed6bc 100644
--- a/internal/contracts/types.go
+++ b/internal/contracts/types.go
@@ -1,21 +1,34 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package contracts
 
 // OutputFormat matches the `/search?format=...` values.
 type OutputFormat string
 
 const (
-	FormatHTML OutputFormat = "html" // accepted for compatibility (not yet implemented)
+	FormatHTML OutputFormat = "html" // accepted for compatibility
 	FormatJSON OutputFormat = "json"
 	FormatCSV  OutputFormat = "csv"
 	FormatRSS  OutputFormat = "rss"
 )
 
 type SearchRequest struct {
-	// Format is what the client requested via `format=...`.
-	Format OutputFormat
-
-	Query string
-
+	Format     OutputFormat
+	Query      string
 	Pageno     int
 	Safesearch int
 	TimeRange  *string
@@ -23,16 +36,14 @@ type SearchRequest struct {
 	TimeoutLimit *float64
 	Language     string
 
-	// Engines and categories are used for deciding which engines run locally vs are proxied.
-	// For now, engines can be supplied directly via the `engines` form parameter.
+	// Engines and categories decide which engines run locally vs proxy to upstream.
 	Engines    []string
 	Categories []string
 
 	// EngineData matches the `engine_data-<engine>-<key>=<value>` parameters.
 	EngineData map[string]map[string]string
 
-	// AccessToken is an optional request token used to gate paid/limited engines.
-	// It is not part of the upstream JSON schema; it only influences local engines.
+	// AccessToken gates paid/limited engines. Not part of upstream JSON schema.
 	AccessToken string
 }
 
diff --git a/internal/engines/arxiv.go b/internal/engines/arxiv.go
index 5565f7f..1347562 100644
--- a/internal/engines/arxiv.go
+++ b/internal/engines/arxiv.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package engines
 
 import (
diff --git a/internal/engines/bing.go b/internal/engines/bing.go
index ff1a5da..85c3f65 100644
--- a/internal/engines/bing.go
+++ b/internal/engines/bing.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package engines
 
 import (
diff --git a/internal/engines/braveapi.go b/internal/engines/braveapi.go
index 77c7abe..81d1f3b 100644
--- a/internal/engines/braveapi.go
+++ b/internal/engines/braveapi.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package engines
 
 import (
@@ -14,13 +30,9 @@ import (
 	"github.com/metamorphosis-dev/kafka/internal/contracts"
 )
 
-// BraveEngine implements the `braveapi` engine (Brave Web Search API).
-//
-// Config / gating:
-// - BRAVE_API_KEY: required to call Brave
-// - BRAVE_ACCESS_TOKEN (optional): if set, the request must include a token
-//   that matches the env var (via Authorization Bearer, X-Search-Token,
-//   X-Brave-Access-Token, or form field `token`).
+// BraveEngine implements the Brave Web Search API.
+// Required: BRAVE_API_KEY env var or config.
+// Optional: BRAVE_ACCESS_TOKEN to gate requests.
 type BraveEngine struct {
 	client          *http.Client
 	apiKey          string
@@ -35,8 +47,6 @@ func (e *BraveEngine) Search(ctx context.Context, req contracts.SearchRequest) (
 		return contracts.SearchResponse{}, errors.New("brave engine not initialized")
 	}
 
-	// Gate / config checks should not be treated as fatal errors; the reference
-	// implementation treats misconfigured engines as unresponsive.
 	if strings.TrimSpace(e.apiKey) == "" {
 		return contracts.SearchResponse{
 			Query:               req.Query,
@@ -93,8 +103,6 @@ func (e *BraveEngine) Search(ctx context.Context, req contracts.SearchRequest) (
 		}
 	}
 
-	// The reference implementation checks `if params["safesearch"]:` which treats any
-	// non-zero (moderate/strict) as strict.
 	if req.Safesearch > 0 {
 		args.Set("safesearch", "strict")
 	}
diff --git a/internal/engines/crossref.go b/internal/engines/crossref.go
index cdcc0b4..cc33759 100644
--- a/internal/engines/crossref.go
+++ b/internal/engines/crossref.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package engines
 
 import (
diff --git a/internal/engines/duckduckgo.go b/internal/engines/duckduckgo.go
index 28b4972..158d483 100644
--- a/internal/engines/duckduckgo.go
+++ b/internal/engines/duckduckgo.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package engines
 
 import (
diff --git a/internal/engines/duckduckgo_parse.go b/internal/engines/duckduckgo_parse.go
index b3935e4..407029c 100644
--- a/internal/engines/duckduckgo_parse.go
+++ b/internal/engines/duckduckgo_parse.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package engines
 
 import (
diff --git a/internal/engines/engine.go b/internal/engines/engine.go
index ee87cfd..729af2b 100644
--- a/internal/engines/engine.go
+++ b/internal/engines/engine.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package engines
 
 import (
diff --git a/internal/engines/factory.go b/internal/engines/factory.go
index b7f3c00..528dcb7 100644
--- a/internal/engines/factory.go
+++ b/internal/engines/factory.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package engines
 
 import (
@@ -8,9 +24,8 @@ import (
 	"github.com/metamorphosis-dev/kafka/internal/config"
 )
 
-// NewDefaultPortedEngines returns the starter set of Go-native engines.
-// The service can swap/extend this registry later as more engines are ported.
-// If cfg is nil, falls back to reading API keys from environment variables.
+// NewDefaultPortedEngines returns the Go-native engine registry.
+// If cfg is nil, API keys fall back to environment variables.
 func NewDefaultPortedEngines(client *http.Client, cfg *config.Config) map[string]Engine {
 	if client == nil {
 		client = &http.Client{Timeout: 10 * time.Second}
diff --git a/internal/engines/github.go b/internal/engines/github.go
index 44102f0..f37cddc 100644
--- a/internal/engines/github.go
+++ b/internal/engines/github.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package engines
 
 import (
diff --git a/internal/engines/google.go b/internal/engines/google.go
index 71b50d1..8563829 100644
--- a/internal/engines/google.go
+++ b/internal/engines/google.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package engines
 
 import (
@@ -41,7 +57,6 @@ func (e *GoogleEngine) Search(ctx context.Context, req contracts.SearchRequest)
 	start := (req.Pageno - 1) * 10
 	query := url.QueryEscape(req.Query)
 
-	// Build URL like SearXNG does.
 	u := fmt.Sprintf(
 		"https://www.google.com/search?q=%s&filter=0&start=%d&hl=%s&lr=%s&safe=%s",
 		query,
@@ -102,7 +117,6 @@ func (e *GoogleEngine) Search(ctx context.Context, req contracts.SearchRequest)
 	}, nil
 }
 
-// detectGoogleSorry returns true if the response is a Google block/CAPTCHA page.
 func detectGoogleSorry(resp *http.Response) bool {
 	if resp.Request != nil {
 		if resp.Request.URL.Host == "sorry.google.com" || strings.HasPrefix(resp.Request.URL.Path, "/sorry") {
@@ -112,16 +126,9 @@ func detectGoogleSorry(resp *http.Response) bool {
 	return false
 }
 
-// parseGoogleResults extracts search results from Google's HTML.
-// Uses the same selectors as SearXNG: div.MjjYud for result containers.
 func parseGoogleResults(body, query string) []contracts.MainResult {
 	var results []contracts.MainResult
 
-	// SearXNG selector: .//div[contains(@class, "MjjYud")]
-	// Each result block contains a title link and snippet.
-	// We simulate the XPath matching with regex-based extraction.
-
-	// Find all MjjYud div blocks.
 	mjjPattern := regexp.MustCompile(`<div[^>]*class="[^"]*MjjYud[^"]*"[^>]*>(.*?)</div>\s*(?=<div[^>]*class="[^"]*MjjYud|$)`)
 	matches := mjjPattern.FindAllStringSubmatch(body, -1)
 
@@ -131,15 +138,12 @@ func parseGoogleResults(body, query string) []contracts.MainResult {
 		}
 		block := match[1]
 
-		// Extract title and URL from the result link.
-		// Pattern: <a href="/url?q=ACTUAL_URL&amp;sa=..." ...>TITLE</a>
 		urlPattern := regexp.MustCompile(`<a[^>]+href="(/url\?q=[^"&]+)`)
 		urlMatch := urlPattern.FindStringSubmatch(block)
 		if len(urlMatch) < 2 {
 			continue
 		}
 		rawURL := urlMatch[1]
-		// Remove /url?q= prefix and decode.
 		actualURL := strings.TrimPrefix(rawURL, "/url?q=")
 		if amp := strings.Index(actualURL, "&amp;"); amp != -1 {
 			actualURL = actualURL[:amp]
@@ -152,14 +156,12 @@ func parseGoogleResults(body, query string) []contracts.MainResult {
 			continue
 		}
 
-		// Extract title from the title tag.
 		titlePattern := regexp.MustCompile(`<span[^>]*class="[^"]*qrStP[^"]*"[^>]*>([^<]+)</span>`)
 		titleMatch := titlePattern.FindStringSubmatch(block)
 		title := query
 		if len(titleMatch) >= 2 {
 			title = stripTags(titleMatch[1])
 		} else {
-			// Fallback: extract visible text from an <a> with data-title or role="link"
 			linkTitlePattern := regexp.MustCompile(`<a[^>]+role="link"[^>]*>([^<]+)<`)
 			ltMatch := linkTitlePattern.FindStringSubmatch(block)
 			if len(ltMatch) >= 2 {
@@ -167,7 +169,6 @@ func parseGoogleResults(body, query string) []contracts.MainResult {
 			}
 		}
 
-		// Extract snippet from data-sncf divs (SearXNG's approach).
 		snippet := extractGoogleSnippet(block)
 
 		urlPtr := actualURL
@@ -186,10 +187,7 @@ func parseGoogleResults(body, query string) []contracts.MainResult {
 	return results
 }
 
-// extractGoogleSnippet extracts the snippet text from a Google result block.
 func extractGoogleSnippet(block string) string {
-	// Google's snippets live in divs with data-sncf attribute.
-	// SearXNG looks for: .//div[contains(@data-sncf, "1")]
 	snippetPattern := regexp.MustCompile(`<div[^>]+data-sncf="1"[^>]*>(.*?)</div>`)
 	matches := snippetPattern.FindAllStringSubmatch(block, -1)
 	var parts []string
@@ -205,10 +203,8 @@ func extractGoogleSnippet(block string) string {
 	return strings.Join(parts, " ")
 }
 
-// extractGoogleSuggestions extracts search suggestions from Google result cards.
 func extractGoogleSuggestions(body string) []string {
 	var suggestions []string
-	// SearXNG xpath: //div[contains(@class, "ouy7Mc")]//a
 	suggestionPattern := regexp.MustCompile(`(?s)<div[^>]*class="[^"]*ouy7Mc[^"]*"[^>]*>.*?<a[^>]*>([^<]+)</a>`)
 	matches := suggestionPattern.FindAllStringSubmatch(body, -1)
 	seen := map[string]bool{}
@@ -225,8 +221,6 @@ func extractGoogleSuggestions(body string) []string {
 	return suggestions
 }
 
-// googleHL maps SearXNG locale to Google hl (host language) parameter.
-// e.g. "en-US" -> "en-US"
 func googleHL(lang string) string {
 	lang = strings.ToLower(strings.TrimSpace(lang))
 	if lang == "" || lang == "auto" {
@@ -235,8 +229,6 @@ func googleHL(lang string) string {
 	return lang
 }
 
-// googleUILanguage maps SearXNG language to Google lr (language restrict) parameter.
-// e.g. "en" -> "lang_en", "de" -> "lang_de"
 func googleUILanguage(lang string) string {
 	lang = strings.ToLower(strings.Split(lang, "-")[0])
 	if lang == "" || lang == "auto" {
@@ -245,7 +237,6 @@ func googleUILanguage(lang string) string {
 	return "lang_" + lang
 }
 
-// googleSafeSearchLevel maps safesearch (0-2) to Google's safe parameter.
 func googleSafeSearchLevel(safesearch int) string {
 	switch safesearch {
 	case 0:
@@ -259,7 +250,6 @@ func googleSafeSearchLevel(safesearch int) string {
 	}
 }
 
-// stripTags removes HTML tags from a string.
 func stripTags(s string) string {
 	stripper := regexp.MustCompile(`<[^>]*>`)
 	s = stripper.ReplaceAllString(s, "")
diff --git a/internal/engines/html_helpers.go b/internal/engines/html_helpers.go
index fd94730..66690c3 100644
--- a/internal/engines/html_helpers.go
+++ b/internal/engines/html_helpers.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package engines
 
 import (
diff --git a/internal/engines/planner.go b/internal/engines/planner.go
index b180f7e..9616a4b 100644
--- a/internal/engines/planner.go
+++ b/internal/engines/planner.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package engines
 
 import (
@@ -79,9 +95,6 @@ func (p *Planner) Plan(req contracts.SearchRequest) (localEngines, upstreamEngin
 }
 
 func inferFromCategories(categories []string) []string {
-	// Minimal mapping for the initial porting subset.
-	// This mirrors the idea of selecting from engine categories without
-	// embedding the whole engine registry.
 	set := map[string]bool{}
 	for _, c := range categories {
 		switch strings.TrimSpace(strings.ToLower(c)) {
@@ -115,7 +128,6 @@ func inferFromCategories(categories []string) []string {
 }
 
 func sortByOrder(list []string, order map[string]int) {
-	// simple insertion sort (list is tiny)
 	for i := 1; i < len(list); i++ {
 		j := i
 		for j > 0 && order[list[j-1]] > order[list[j]] {
diff --git a/internal/engines/qwant.go b/internal/engines/qwant.go
index 8221781..e15d4f2 100644
--- a/internal/engines/qwant.go
+++ b/internal/engines/qwant.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package engines
 
 import (
@@ -14,11 +30,7 @@ import (
 	"github.com/PuerkitoBio/goquery"
 )
 
-// QwantEngine implements a `qwant` (web) adapter using
-// Qwant v3 endpoint: https://api.qwant.com/v3/search/web.
-//
-// Qwant's API is not fully documented; this implements parsing logic
-// for the `web` category.
+// QwantEngine implements the Qwant v3 API (web and web-lite modes).
 type QwantEngine struct {
 	client        *http.Client
 	category      string // "web" (JSON API) or "web-lite" (HTML fallback)
@@ -37,8 +49,6 @@ func (e *QwantEngine) Search(ctx context.Context, req contracts.SearchRequest) (
 		return contracts.SearchResponse{Query: req.Query}, nil
 	}
 
-	// For API parity we use web defaults: count=10, offset=(pageno-1)*count.
-	// The engine's config field exists so we can expand to news/images/videos later.
 	count := e.resultsPerPage
 	if count <= 0 {
 		count = 10
@@ -255,9 +265,7 @@ func (e *QwantEngine) searchWebLite(ctx context.Context, req contracts.SearchReq
 	results := make([]contracts.MainResult, 0)
 	seen := map[string]bool{}
 
-	// Pattern 1: legacy/known qwant-lite structure.
 	doc.Find("section article").Each(func(_ int, item *goquery.Selection) {
-		// ignore randomly interspersed advertising adds
 		if item.Find("span.tooltip").Length() > 0 {
 			return
 		}
@@ -291,19 +299,14 @@ func (e *QwantEngine) searchWebLite(ctx context.Context, req contracts.SearchReq
 		})
 	})
 
-	// Pattern 2: broader fallback for updated lite markup:
-	// any article/list item/div block containing an external anchor.
-	// We keep this conservative by requiring non-empty title + URL.
 	doc.Find("article, li, div").Each(func(_ int, item *goquery.Selection) {
 		if len(results) >= 20 {
 			return
 		}
-		// Skip ad-like blocks in fallback pass too.
 		if item.Find("span.tooltip").Length() > 0 {
 			return
 		}
 
-		// Skip obvious nav/footer blocks.
 		classAttr, _ := item.Attr("class")
 		classLower := strings.ToLower(classAttr)
 		if strings.Contains(classLower, "nav") || strings.Contains(classLower, "footer") {
@@ -352,13 +355,10 @@ func (e *QwantEngine) searchWebLite(ctx context.Context, req contracts.SearchReq
 		}
 		seen[href] = true
 
-		// Best-effort snippet extraction from nearby paragraph/span text.
 		content := strings.TrimSpace(item.Find("p").First().Text())
 		if content == "" {
 			content = strings.TrimSpace(item.Find("span").First().Text())
 		}
-		// If there is no snippet, still keep clearly external result links.
-		// Qwant-lite frequently omits rich snippets for some entries.
 
 		u := href
 		results = append(results, contracts.MainResult{
diff --git a/internal/engines/reddit.go b/internal/engines/reddit.go
index 6ba98e4..788f52a 100644
--- a/internal/engines/reddit.go
+++ b/internal/engines/reddit.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package engines
 
 import (
diff --git a/internal/engines/wikipedia.go b/internal/engines/wikipedia.go
index bff708e..bbf1222 100644
--- a/internal/engines/wikipedia.go
+++ b/internal/engines/wikipedia.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package engines
 
 import (
diff --git a/internal/engines/youtube.go b/internal/engines/youtube.go
index a18abd8..5946aa4 100644
--- a/internal/engines/youtube.go
+++ b/internal/engines/youtube.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package engines
 
 import (
diff --git a/internal/httpapi/handlers.go b/internal/httpapi/handlers.go
index 837a336..cc19b4b 100644
--- a/internal/httpapi/handlers.go
+++ b/internal/httpapi/handlers.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package httpapi
 
 import (
@@ -14,12 +30,14 @@ import (
 type Handler struct {
 	searchSvc          *search.Service
 	autocompleteSvc    func(ctx context.Context, query string) ([]string, error)
+	sourceURL          string
 }
 
-func NewHandler(searchSvc *search.Service, autocompleteSuggestions func(ctx context.Context, query string) ([]string, error)) *Handler {
+func NewHandler(searchSvc *search.Service, autocompleteSuggestions func(ctx context.Context, query string) ([]string, error), sourceURL string) *Handler {
 	return &Handler{
 		searchSvc:       searchSvc,
 		autocompleteSvc: autocompleteSuggestions,
+		sourceURL:       sourceURL,
 	}
 }
 
@@ -35,7 +53,7 @@ func (h *Handler) Index(w http.ResponseWriter, r *http.Request) {
 		http.NotFound(w, r)
 		return
 	}
-	if err := views.RenderIndex(w); err != nil {
+	if err := views.RenderIndex(w, h.sourceURL); err != nil {
 		http.Error(w, err.Error(), http.StatusInternalServerError)
 	}
 }
@@ -64,7 +82,7 @@ func (h *Handler) Search(w http.ResponseWriter, r *http.Request) {
 	if err != nil {
 		// For HTML, render error on the results page.
 		if req.Format == contracts.FormatHTML || r.FormValue("format") == "html" {
-			pd := views.PageData{Query: r.FormValue("q")}
+			pd := views.PageData{SourceURL: h.sourceURL, Query: r.FormValue("q")}
 			if views.IsHTMXRequest(r) {
 				views.RenderSearchFragment(w, pd)
 			} else {
@@ -79,7 +97,7 @@ func (h *Handler) Search(w http.ResponseWriter, r *http.Request) {
 	resp, err := h.searchSvc.Search(r.Context(), req)
 	if err != nil {
 		if req.Format == contracts.FormatHTML {
-			pd := views.PageData{Query: req.Query}
+			pd := views.PageData{SourceURL: h.sourceURL, Query: req.Query}
 			if views.IsHTMXRequest(r) {
 				views.RenderSearchFragment(w, pd)
 			} else {
diff --git a/internal/middleware/cors.go b/internal/middleware/cors.go
index 7b4000e..ee90ab0 100644
--- a/internal/middleware/cors.go
+++ b/internal/middleware/cors.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package middleware
 
 import (
diff --git a/internal/middleware/ratelimit.go b/internal/middleware/ratelimit.go
index 5102f9a..78774f2 100644
--- a/internal/middleware/ratelimit.go
+++ b/internal/middleware/ratelimit.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package middleware
 
 import (
@@ -11,19 +27,12 @@ import (
 	"log/slog"
 )
 
-// RateLimitConfig controls per-IP rate limiting using a sliding window counter.
 type RateLimitConfig struct {
-	// Requests is the max number of requests allowed per window.
-	Requests int
-	// Window is the time window duration (e.g. "1m").
-	Window time.Duration
-	// CleanupInterval is how often stale entries are purged (default: 5m).
+	Requests        int
+	Window          time.Duration
 	CleanupInterval time.Duration
 }
 
-// RateLimit returns a middleware that limits requests per IP address.
-// Uses an in-memory sliding window counter. When the limit is exceeded,
-// responds with HTTP 429 and a Retry-After header.
 func RateLimit(cfg RateLimitConfig, logger *slog.Logger) func(http.Handler) http.Handler {
 	requests := cfg.Requests
 	if requests <= 0 {
diff --git a/internal/middleware/ratelimit_global.go b/internal/middleware/ratelimit_global.go
index 1f94dc9..538c435 100644
--- a/internal/middleware/ratelimit_global.go
+++ b/internal/middleware/ratelimit_global.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package middleware
 
 import (
diff --git a/internal/search/merge.go b/internal/search/merge.go
index 64ebd6e..0e8a15a 100644
--- a/internal/search/merge.go
+++ b/internal/search/merge.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package search
 
 import (
@@ -9,11 +25,6 @@ import (
 )
 
 // MergeResponses merges multiple compatible JSON responses.
-//
-// MVP merge semantics:
-// - results are concatenated with a simple de-dup key (engine|title|url)
-// - suggestions/corrections are de-duplicated as sets
-// - answers/infoboxes/unresponsive_engines are concatenated (best-effort)
 func MergeResponses(responses []contracts.SearchResponse) contracts.SearchResponse {
 	var merged contracts.SearchResponse
 
diff --git a/internal/search/request_params.go b/internal/search/request_params.go
index 9fdd799..baad193 100644
--- a/internal/search/request_params.go
+++ b/internal/search/request_params.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package search
 
 import (
diff --git a/internal/search/response.go b/internal/search/response.go
index 1a9ce26..1279a07 100644
--- a/internal/search/response.go
+++ b/internal/search/response.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package search
 
 import (
diff --git a/internal/search/service.go b/internal/search/service.go
index 47d2895..2ac9718 100644
--- a/internal/search/service.go
+++ b/internal/search/service.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package search
 
 import (
diff --git a/internal/search/types.go b/internal/search/types.go
index b4694bb..89b323d 100644
--- a/internal/search/types.go
+++ b/internal/search/types.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package search
 
 import "github.com/metamorphosis-dev/kafka/internal/contracts"
@@ -7,7 +23,7 @@ import "github.com/metamorphosis-dev/kafka/internal/contracts"
 type OutputFormat = contracts.OutputFormat
 
 const (
-	FormatHTML = contracts.FormatHTML // accepted for compatibility (not yet implemented)
+	FormatHTML = contracts.FormatHTML // accepted for compatibility
 	FormatJSON = contracts.FormatJSON
 	FormatCSV  = contracts.FormatCSV
 	FormatRSS  = contracts.FormatRSS
diff --git a/internal/upstream/client.go b/internal/upstream/client.go
index 64ddec4..2bff509 100644
--- a/internal/upstream/client.go
+++ b/internal/upstream/client.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package upstream
 
 import (
diff --git a/internal/views/static/css/kafka.css b/internal/views/static/css/kafka.css
index b637860..8ae97ea 100644
--- a/internal/views/static/css/kafka.css
+++ b/internal/views/static/css/kafka.css
@@ -1,71 +1,49 @@
-/* kafka — clean, minimal search engine CSS */
+/* ============================================================
+   kafka — modern, clean search UI
+   ============================================================ */
 
 :root {
-  --color-base: #f5f5f5;
-  --color-base-font: #444;
-  --color-base-background: #fff;
-  --color-header-background: #f7f7f7;
-  --color-header-border: #ddd;
-  --color-search-border: #bbb;
-  --color-search-focus: #3498db;
-  --color-result-url: #1a0dab;
-  --color-result-url-visited: #609;
-  --color-result-content: #545454;
-  --color-result-title: #1a0dab;
-  --color-result-title-visited: #609;
-  --color-result-engine: #666;
-  --color-result-border: #eee;
-  --color-link: #3498db;
-  --color-link-visited: #609;
-  --color-sidebar-background: #f7f7f7;
-  --color-sidebar-border: #ddd;
-  --color-infobox-background: #f9f9f9;
-  --color-infobox-border: #ddd;
-  --color-pagination-current: #3498db;
-  --color-pagination-border: #ddd;
-  --color-error: #c0392b;
-  --color-error-background: #fdecea;
-  --color-suggestion: #666;
-  --color-footer: #888;
-  --color-btn-background: #fff;
-  --color-btn-border: #ddd;
-  --color-btn-hover: #eee;
-  --radius: 4px;
-  --max-width: 800px;
+  /* Light theme */
+  --bg: #ffffff;
+  --bg-secondary: #f8f9fa;
+  --bg-tertiary: #f1f3f5;
+  --border: #e9ecef;
+  --border-focus: #cad1d8;
+  --text-primary: #1a1a1a;
+  --text-secondary: #5c6370;
+  --text-muted: #8b929e;
+  --accent: #2563eb;
+  --accent-hover: #1d4ed8;
+  --accent-soft: #eff6ff;
+  --accent-glow: rgba(37, 99, 235, 0.15);
+  --shadow-sm: 0 1px 3px rgba(0,0,0,0.06), 0 1px 2px rgba(0,0,0,0.04);
+  --shadow-md: 0 4px 12px rgba(0,0,0,0.08), 0 2px 4px rgba(0,0,0,0.04);
+  --shadow-lg: 0 12px 32px rgba(0,0,0,0.12), 0 4px 8px rgba(0,0,0,0.06);
+  --radius-sm: 8px;
+  --radius-md: 12px;
+  --radius-lg: 16px;
+  --radius-full: 9999px;
+  --font: -apple-system, BlinkMacSystemFont, "SF Pro Display", "Segoe UI", Roboto, sans-serif;
+  --max-width: 880px;
+  --header-height: 56px;
 }
 
-@media (prefers-color-scheme: dark) {
-  :root {
-    --color-base: #222;
-    --color-base-font: #dcdcdc;
-    --color-base-background: #2b2b2b;
-    --color-header-background: #333;
-    --color-header-border: #444;
-    --color-search-border: #555;
-    --color-search-focus: #5dade2;
-    --color-result-url: #8ab4f8;
-    --color-result-url-visited: #b39ddb;
-    --color-result-content: #b0b0b0;
-    --color-result-title: #8ab4f8;
-    --color-result-title-visited: #b39ddb;
-    --color-result-engine: #999;
-    --color-result-border: #3a3a3a;
-    --color-link: #5dade2;
-    --color-link-visited: #b39ddb;
-    --color-sidebar-background: #333;
-    --color-sidebar-border: #444;
-    --color-infobox-background: #333;
-    --color-infobox-border: #444;
-    --color-pagination-current: #5dade2;
-    --color-pagination-border: #444;
-    --color-error: #e74c3c;
-    --color-error-background: #3b1a1a;
-    --color-suggestion: #999;
-    --color-footer: #666;
-    --color-btn-background: #333;
-    --color-btn-border: #555;
-    --color-btn-hover: #444;
-  }
+[data-theme="dark"] {
+  --bg: #0f0f0f;
+  --bg-secondary: #1a1a1a;
+  --bg-tertiary: #242424;
+  --border: #2e2e2e;
+  --border-focus: #404040;
+  --text-primary: #e8eaed;
+  --text-secondary: #9aa0a6;
+  --text-muted: #6b7280;
+  --accent: #60a5fa;
+  --accent-hover: #93c5fd;
+  --accent-soft: #1e3a5f;
+  --accent-glow: rgba(96, 165, 250, 0.2);
+  --shadow-sm: 0 1px 3px rgba(0,0,0,0.3);
+  --shadow-md: 0 4px 12px rgba(0,0,0,0.4);
+  --shadow-lg: 0 12px 32px rgba(0,0,0,0.5);
 }
 
 *, *::before, *::after {
@@ -76,35 +54,491 @@
 
 html {
   font-size: 16px;
+  scroll-behavior: smooth;
 }
 
 body {
-  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
-  color: var(--color-base-font);
-  background: var(--color-base);
-  line-height: 1.6;
+  font-family: var(--font);
+  background: var(--bg);
+  color: var(--text-primary);
+  line-height: 1.5;
   min-height: 100vh;
-  display: flex;
-  flex-direction: column;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
 }
 
-main {
-  flex: 1;
-  max-width: var(--max-width);
-  width: 100%;
-  margin: 0 auto;
-  padding: 1rem;
+/* ============================================================
+   Header
+   ============================================================ */
+
+.site-header {
+  position: sticky;
+  top: 0;
+  z-index: 100;
+  height: var(--header-height);
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 0 1.5rem;
+  background: var(--bg);
+  border-bottom: 1px solid var(--border);
+  backdrop-filter: blur(12px);
+  background: color-mix(in srgb, var(--bg) 90%, transparent);
 }
 
+.site-logo {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  text-decoration: none;
+  color: var(--text-primary);
+}
+
+.site-logo-mark {
+  width: 28px;
+  height: 28px;
+  color: var(--accent);
+}
+
+.site-name {
+  font-size: 1.1rem;
+  font-weight: 600;
+  letter-spacing: -0.01em;
+}
+
+.settings-trigger {
+  background: none;
+  border: none;
+  width: 36px;
+  height: 36px;
+  border-radius: var(--radius-sm);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  cursor: pointer;
+  color: var(--text-secondary);
+  transition: background 0.15s, color 0.15s;
+}
+.settings-trigger:hover {
+  background: var(--bg-tertiary);
+  color: var(--text-primary);
+}
+
+/* ============================================================
+   Main Layout
+   ============================================================ */
+
+main {
+  max-width: var(--max-width);
+  margin: 0 auto;
+  padding: 0 1.5rem;
+}
+
+/* ============================================================
+   Homepage — Hero Search
+   ============================================================ */
+
+.page-home {
+  min-height: calc(100vh - var(--header-height));
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  padding: 4rem 1.5rem;
+  text-align: center;
+}
+
+.hero-logo {
+  margin-bottom: 2rem;
+}
+
+.hero-logo svg {
+  width: 64px;
+  height: 64px;
+  color: var(--accent);
+}
+
+.hero-tagline {
+  font-size: 1rem;
+  color: var(--text-muted);
+  margin-bottom: 2.5rem;
+  max-width: 400px;
+}
+
+.search-hero {
+  width: 100%;
+  max-width: 640px;
+}
+
+.search-box {
+  position: relative;
+  width: 100%;
+}
+
+.search-box input[type="text"],
+#q {
+  width: 100%;
+  padding: 1rem 3.5rem 1rem 1.25rem;
+  font-size: 1.1rem;
+  font-family: inherit;
+  border: 2px solid var(--border);
+  border-radius: var(--radius-full);
+  background: var(--bg);
+  color: var(--text-primary);
+  outline: none;
+  transition: border-color 0.2s, box-shadow 0.2s;
+}
+
+.search-box input[type="text"]:focus,
+#q:focus {
+  border-color: var(--accent);
+  box-shadow: var(--shadow-lg), 0 0 0 4px var(--accent-glow);
+}
+
+.search-box input[type="text"]::placeholder,
+#q::placeholder {
+  color: var(--text-muted);
+}
+
+.search-box-submit {
+  position: absolute;
+  right: 6px;
+  top: 50%;
+  transform: translateY(-50%);
+  width: 40px;
+  height: 40px;
+  border: none;
+  border-radius: var(--radius-full);
+  background: var(--accent);
+  color: #fff;
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  transition: background 0.15s, transform 0.15s;
+}
+
+.search-box-submit:hover {
+  background: var(--accent-hover);
+  transform: translateY(-50%) scale(1.05);
+}
+
+.search-box-submit:active {
+  transform: translateY(-50%) scale(0.97);
+}
+
+/* ============================================================
+   Results Page
+   ============================================================ */
+
+.page-results {
+  padding-top: 1.5rem;
+}
+
+.results-layout {
+  display: grid;
+  grid-template-columns: 1fr 220px;
+  gap: 2rem;
+  align-items: start;
+}
+
+@media (max-width: 700px) {
+  .results-layout {
+    grid-template-columns: 1fr;
+    gap: 1rem;
+  }
+}
+
+/* Compact search bar on results page */
+.search-compact {
+  grid-column: 1 / -1;
+}
+
+.search-compact .search-box {
+  max-width: 100%;
+}
+
+.search-compact input {
+  font-size: 1rem;
+  padding: 0.75rem 2.75rem 0.75rem 1rem;
+}
+
+.search-compact .search-box-submit {
+  width: 34px;
+  height: 34px;
+}
+
+/* ============================================================
+   Results Column
+   ============================================================ */
+
+.results-column {
+  min-width: 0;
+}
+
+/* Result count + meta */
+.results-meta {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  margin-bottom: 1rem;
+  font-size: 0.85rem;
+  color: var(--text-muted);
+}
+
+/* Individual result card */
+.result {
+  background: var(--bg);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-md);
+  padding: 1rem 1.1rem;
+  margin-bottom: 0.75rem;
+  transition: border-color 0.15s, box-shadow 0.15s, transform 0.15s;
+}
+
+.result:hover {
+  border-color: var(--border-focus);
+  box-shadow: var(--shadow-sm);
+  transform: translateY(-1px);
+}
+
+.result_header {
+  margin-bottom: 0.25rem;
+}
+
+.result-favicon {
+  display: inline-block;
+  width: 16px;
+  height: 16px;
+  border-radius: 3px;
+  vertical-align: middle;
+  margin-right: 0.4rem;
+  background: var(--bg-tertiary);
+  flex-shrink: 0;
+}
+
+.result_url {
+  display: flex;
+  align-items: center;
+  gap: 0.4rem;
+  font-size: 0.8rem;
+  color: var(--text-muted);
+  margin-bottom: 0.35rem;
+  overflow: hidden;
+}
+
+.result_url a {
+  color: var(--text-muted);
+  text-decoration: none;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.result_url a:hover {
+  color: var(--accent);
+}
+
+.result_url .engine-badge {
+  flex-shrink: 0;
+  display: inline-flex;
+  align-items: center;
+  gap: 0.25rem;
+  padding: 0.1rem 0.4rem;
+  background: var(--bg-tertiary);
+  border-radius: var(--radius-sm);
+  font-size: 0.7rem;
+  color: var(--text-muted);
+  margin-left: auto;
+}
+
+.result_header a {
+  font-size: 1rem;
+  font-weight: 500;
+  color: var(--text-primary);
+  text-decoration: none;
+  line-height: 1.4;
+  display: block;
+}
+
+.result_header a:hover {
+  color: var(--accent);
+}
+
+.result_header a:visited {
+  color: var(--text-secondary);
+}
+
+.result_content {
+  font-size: 0.9rem;
+  color: var(--text-secondary);
+  line-height: 1.55;
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+
+/* ============================================================
+   Sidebar
+   ============================================================ */
+
+.sidebar {
+  position: sticky;
+  top: calc(var(--header-height) + 1.5rem);
+}
+
+.sidebar-card {
+  background: var(--bg);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-md);
+  padding: 1rem;
+  margin-bottom: 1rem;
+}
+
+.sidebar-title {
+  font-size: 0.75rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--text-muted);
+  margin-bottom: 0.75rem;
+}
+
+/* Suggestions in sidebar */
+.suggestion-list {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.4rem;
+}
+
+.suggestion a {
+  display: inline-block;
+  padding: 0.3rem 0.65rem;
+  font-size: 0.8rem;
+  border: 1px solid var(--border);
+  border-radius: var(--radius-full);
+  color: var(--accent);
+  text-decoration: none;
+  background: var(--accent-soft);
+  transition: background 0.15s, border-color 0.15s;
+}
+
+.suggestion a:hover {
+  background: color-mix(in srgb, var(--accent-soft) 70%, var(--bg-tertiary));
+  border-color: var(--accent);
+}
+
+/* Unresponsive engines warning */
+.unresponsive-engines {
+  font-size: 0.8rem;
+  color: var(--text-muted);
+}
+
+.unresponsive-engines li {
+  margin: 0.3rem 0;
+}
+
+/* Corrections */
+.correction {
+  font-size: 0.85rem;
+  color: var(--text-muted);
+  margin-bottom: 0.5rem;
+}
+
+/* ============================================================
+   No Results
+   ============================================================ */
+
+.no-results {
+  text-align: center;
+  padding: 4rem 2rem;
+}
+
+.no-results-icon {
+  font-size: 3rem;
+  margin-bottom: 1rem;
+  opacity: 0.3;
+}
+
+.no-results h2 {
+  font-size: 1.25rem;
+  font-weight: 500;
+  margin-bottom: 0.5rem;
+}
+
+.no-results p {
+  color: var(--text-muted);
+  font-size: 0.95rem;
+}
+
+/* ============================================================
+   Pagination
+   ============================================================ */
+
+.pagination {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.4rem;
+  padding: 2rem 0;
+  flex-wrap: wrap;
+}
+
+.pagination button,
+.pagination .page-link {
+  min-width: 40px;
+  height: 40px;
+  padding: 0 0.75rem;
+  border: 1px solid var(--border);
+  border-radius: var(--radius-sm);
+  background: var(--bg);
+  color: var(--text-primary);
+  font-size: 0.9rem;
+  font-family: inherit;
+  cursor: pointer;
+  text-decoration: none;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  transition: background 0.15s, border-color 0.15s, color 0.15s;
+}
+
+.pagination button:hover,
+.pagination .page-link:hover {
+  background: var(--bg-tertiary);
+  border-color: var(--border-focus);
+}
+
+.pagination .page-current {
+  background: var(--accent);
+  border-color: var(--accent);
+  color: #fff;
+}
+
+.pagination .page-current:hover {
+  background: var(--accent-hover);
+  border-color: var(--accent-hover);
+}
+
+.pagination .prev-next {
+  font-weight: 500;
+}
+
+/* ============================================================
+   Footer
+   ============================================================ */
+
 footer {
   text-align: center;
-  padding: 1.5rem;
-  color: var(--color-footer);
+  padding: 3rem 1.5rem 2rem;
+  color: var(--text-muted);
   font-size: 0.85rem;
+  margin-top: auto;
 }
 
 footer a {
-  color: var(--color-link);
+  color: var(--accent);
   text-decoration: none;
 }
 
@@ -112,331 +546,21 @@ footer a:hover {
   text-decoration: underline;
 }
 
-/* Index / Homepage */
-.index {
-  display: flex;
-  flex-direction: column;
-  align-items: center;
-  justify-content: center;
-  min-height: 60vh;
-  text-align: center;
-}
-
-.index .title h1 {
-  font-size: 2rem;
-  font-weight: 300;
-  margin-bottom: 2rem;
-  letter-spacing: 0.05em;
-}
-
-/* Search form */
-#search {
-  width: 100%;
-  max-width: 600px;
-  margin-bottom: 2rem;
-}
-
-#search form {
-  display: flex;
-  gap: 0.5rem;
-}
-
-#search input[type="text"],
-#q {
-  flex: 1;
-  padding: 0.7rem 1rem;
-  font-size: 1rem;
-  border: 1px solid var(--color-search-border);
-  border-radius: var(--radius);
-  background: var(--color-base-background);
-  color: var(--color-base-font);
-  outline: none;
-  transition: border-color 0.2s;
-}
-
-#search input[type="text"]:focus,
-#q:focus {
-  border-color: var(--color-search-focus);
-  box-shadow: 0 0 0 2px rgba(52, 152, 219, 0.15);
-}
-
-#search button[type="submit"] {
-  padding: 0.7rem 1.2rem;
-  font-size: 1rem;
-  border: 1px solid var(--color-search-border);
-  border-radius: var(--radius);
-  background: var(--color-btn-background);
-  color: var(--color-base-font);
-  cursor: pointer;
-  transition: background 0.2s;
-}
-
-#search button[type="submit"]:hover {
-  background: var(--color-btn-hover);
-}
-
-/* Results page search bar (compact) */
-.search_on_results #search {
-  max-width: 100%;
-  margin-bottom: 1rem;
-}
-
-/* Results area */
-#results {
-  display: flex;
-  gap: 1.5rem;
-}
-
-#sidebar {
-  flex: 0 0 200px;
-  font-size: 0.85rem;
-}
-
-#sidebar p {
-  margin-bottom: 0.5rem;
-}
-
-#urls {
-  flex: 1;
-  min-width: 0;
-}
-
-/* Result count */
-#result_count {
-  margin-bottom: 1rem;
-}
-
-/* Individual result */
-.result {
-  padding: 0.8rem 0;
-  border-bottom: 1px solid var(--color-result-border);
-  word-wrap: break-word;
-}
-
-.result:last-child {
-  border-bottom: none;
-}
-
-.result_header {
-  margin-bottom: 0.2rem;
-}
-
-.result_header a {
-  font-size: 1.1rem;
-  font-weight: 400;
-  color: var(--color-result-title);
-  text-decoration: none;
-}
-
-.result_header a:visited {
-  color: var(--color-result-title-visited);
-}
-
-.result_header a:hover {
-  text-decoration: underline;
-}
-
-.result_url {
-  font-size: 0.85rem;
-  color: var(--color-result-url);
-  margin-bottom: 0.2rem;
-}
-
-.result_url a {
-  color: var(--color-result-url);
-  text-decoration: none;
-}
-
-.result_url a:visited {
-  color: var(--color-result-url-visited);
-}
-
-.result_content {
-  font-size: 0.9rem;
-  color: var(--color-result-content);
-  max-width: 600px;
-}
-
-.result_content p {
-  margin: 0;
-}
-
-.result_engine {
-  font-size: 0.75rem;
-  color: var(--color-result-engine);
-  margin-top: 0.3rem;
-}
-
-.engine {
-  display: inline-block;
-  padding: 0.1rem 0.4rem;
-  background: var(--color-sidebar-background);
-  border: 1px solid var(--color-sidebar-border);
-  border-radius: 2px;
-  font-size: 0.7rem;
-  color: var(--color-result-engine);
-}
-
-/* No results */
-.no_results {
-  text-align: center;
-  padding: 3rem 1rem;
-  color: var(--color-suggestion);
-}
-
-/* Suggestions */
-#suggestions {
-  margin-bottom: 1rem;
-}
-
-.suggestion {
-  display: inline-block;
-  margin: 0.2rem;
-}
-
-.suggestion a {
-  display: inline-block;
-  padding: 0.3rem 0.6rem;
-  font-size: 0.85rem;
-  border: 1px solid var(--color-pagination-border);
-  border-radius: var(--radius);
-  color: var(--color-link);
-  text-decoration: none;
-  background: var(--color-btn-background);
-  transition: background 0.2s;
-}
-
-.suggestion a:hover {
-  background: var(--color-btn-hover);
-}
-
-/* Infoboxes */
-#infoboxes {
-  margin-bottom: 1rem;
-}
-
-.infobox {
-  background: var(--color-infobox-background);
-  border: 1px solid var(--color-infobox-border);
-  border-radius: var(--radius);
-  padding: 0.8rem;
-  margin-bottom: 0.5rem;
-}
-
-.infobox .title {
-  font-weight: 600;
-  margin-bottom: 0.5rem;
-}
-
-/* Errors */
-.dialog-error {
-  background: var(--color-error-background);
-  color: var(--color-error);
-  border: 1px solid var(--color-error);
-  border-radius: var(--radius);
-  padding: 0.8rem 1rem;
-  margin-bottom: 1rem;
-}
-
-/* Unresponsive engines */
-.unresponsive_engines {
-  font-size: 0.8rem;
-  color: var(--color-suggestion);
-  margin-top: 0.5rem;
-}
-
-.unresponsive_engines li {
-  margin: 0.1rem 0;
-}
-
-/* Corrections */
-.correction {
-  font-size: 0.9rem;
-  margin-bottom: 0.5rem;
-}
-
-/* Pagination */
-#pagination {
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  gap: 0.3rem;
-  padding: 1.5rem 0;
-  flex-wrap: wrap;
-}
-
-#pagination button,
-#pagination .page_number,
-#pagination .page_number_current {
-  padding: 0.4rem 0.8rem;
-  font-size: 0.9rem;
-  border: 1px solid var(--color-pagination-border);
-  border-radius: var(--radius);
-  background: var(--color-btn-background);
-  color: var(--color-base-font);
-  cursor: pointer;
-  text-decoration: none;
-  transition: background 0.2s;
-}
-
-#pagination button:hover,
-#pagination .page_number:hover {
-  background: var(--color-btn-hover);
-}
-
-#pagination .page_number_current {
-  background: var(--color-pagination-current);
-  color: #fff;
-  border-color: var(--color-pagination-current);
-  cursor: default;
-}
-
-.previous_page, .next_page {
-  font-weight: 500;
-}
-
-/* Back to top */
-#backToTop {
-  text-align: center;
-  margin: 1rem 0;
-}
-
-#backToTop a {
-  color: var(--color-link);
-  text-decoration: none;
-  font-size: 0.85rem;
-}
-
-/* HTMX loading indicator */
-.htmx-indicator {
-  display: none;
-  text-align: center;
-  padding: 2rem;
-  color: var(--color-suggestion);
-}
-
-.htmx-request .htmx-indicator,
-.htmx-request.htmx-indicator {
-  display: block;
-}
-
-/* Autocomplete dropdown */
-#search {
-  position: relative;
-}
+/* ============================================================
+   Autocomplete Dropdown
+   ============================================================ */
 
 #autocomplete-dropdown {
   position: absolute;
-  top: 100%;
+  top: calc(100% + 6px);
   left: 0;
   right: 0;
-  background: var(--color-base-background);
-  border: 1px solid var(--color-search-border);
-  border-top: none;
-  border-radius: 0 0 var(--radius) var(--radius);
-  box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
-  z-index: 100;
-  max-height: 320px;
+  background: var(--bg);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-md);
+  box-shadow: var(--shadow-lg);
+  z-index: 200;
+  max-height: 360px;
   overflow-y: auto;
   display: none;
 }
@@ -446,12 +570,12 @@ footer a:hover {
 }
 
 .autocomplete-suggestion {
-  padding: 0.6rem 1rem;
+  padding: 0.7rem 1rem;
   cursor: pointer;
   font-size: 0.95rem;
-  color: var(--color-base-font);
-  border-bottom: 1px solid var(--color-result-border);
-  transition: background 0.15s;
+  color: var(--text-primary);
+  border-bottom: 1px solid var(--border);
+  transition: background 0.1s;
 }
 
 .autocomplete-suggestion:last-child {
@@ -460,159 +584,101 @@ footer a:hover {
 
 .autocomplete-suggestion:hover,
 .autocomplete-suggestion.active {
-  background: var(--color-header-background);
+  background: var(--bg-tertiary);
 }
 
 .autocomplete-suggestion mark {
   background: none;
-  color: var(--color-link);
+  color: var(--accent);
   font-weight: 600;
 }
 
 .autocomplete-footer {
-  padding: 0.4rem 1rem;
+  padding: 0.5rem 1rem;
   font-size: 0.75rem;
-  color: var(--color-suggestion);
-  border-top: 1px solid var(--color-result-border);
-  background: var(--color-header-background);
+  color: var(--text-muted);
+  background: var(--bg-secondary);
+  border-radius: 0 0 var(--radius-md) var(--radius-md);
+  border-top: 1px solid var(--border);
 }
 
-/* Responsive */
-@media (max-width: 768px) {
-  #results {
-    flex-direction: column-reverse;
-  }
-
-  #sidebar {
-    flex: none;
-    border-top: 1px solid var(--color-sidebar-border);
-    padding-top: 0.5rem;
-  }
-
-  .index .title h1 {
-    font-size: 1.5rem;
-  }
-
-  main {
-    padding: 0.5rem;
-  }
-}
-
-/* Print */
-@media print {
-  footer, #pagination, #search button, #backToTop, .htmx-indicator {
-    display: none;
-  }
-
-  body {
-    background: #fff;
-    color: #000;
-  }
-
-  .result a {
-    color: #000;
-  }
-}
-
-/* ============================================
+/* ============================================================
    Settings Panel
-   ============================================ */
+   ============================================================ */
 
-/* Header */
-.site-header {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  padding: 0.6rem 1rem;
-  background: var(--color-header-background);
-  border-bottom: 1px solid var(--color-header-border);
-}
-.site-title {
-  font-size: 1rem;
-  font-weight: 600;
-  color: var(--color-base-font);
-}
-
-/* Gear trigger button */
-.settings-trigger {
-  background: none;
-  border: none;
-  font-size: 1.1rem;
-  cursor: pointer;
-  padding: 0.3rem 0.5rem;
-  border-radius: var(--radius);
-  color: var(--color-base-font);
-  opacity: 0.7;
-  transition: opacity 0.2s, background 0.2s;
-  line-height: 1;
-}
-.settings-trigger:hover,
-.settings-trigger[aria-expanded="true"] {
-  opacity: 1;
-  background: var(--color-sidebar-background);
-}
-
-/* Popover panel */
 .settings-popover {
-  position: absolute;
-  top: 100%;
-  right: 0;
-  width: 280px;
-  max-height: 420px;
+  position: fixed;
+  top: calc(var(--header-height) + 8px);
+  right: 1rem;
+  width: 300px;
+  max-height: calc(100vh - var(--header-height) - 2rem);
   overflow-y: auto;
-  background: var(--color-base-background);
-  border: 1px solid var(--color-sidebar-border);
-  border-radius: var(--radius);
-  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.12);
-  z-index: 200;
+  background: var(--bg);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-lg);
+  box-shadow: var(--shadow-lg);
+  z-index: 300;
   display: none;
-  flex-direction: column;
 }
+
 .settings-popover[data-open="true"] {
-  display: flex;
-  animation: settings-slide-in 0.2s ease;
+  display: block;
+  animation: pop-in 0.2s ease;
 }
-@keyframes settings-slide-in {
-  from { opacity: 0; transform: translateY(-8px); }
-  to   { opacity: 1; transform: translateY(0); }
+
+@keyframes pop-in {
+  from { opacity: 0; transform: translateY(-8px) scale(0.97); }
+  to   { opacity: 1; transform: translateY(0) scale(1); }
 }
 
 .settings-popover-header {
   display: flex;
   justify-content: space-between;
   align-items: center;
-  padding: 0.75rem 1rem;
-  border-bottom: 1px solid var(--color-sidebar-border);
+  padding: 1rem 1.25rem;
+  border-bottom: 1px solid var(--border);
   font-weight: 600;
-  font-size: 0.9rem;
-  flex-shrink: 0;
+  font-size: 0.95rem;
+  position: sticky;
+  top: 0;
+  background: var(--bg);
+  z-index: 1;
 }
+
 .settings-popover-close {
   background: none;
   border: none;
-  font-size: 1.2rem;
+  width: 28px;
+  height: 28px;
+  border-radius: var(--radius-sm);
   cursor: pointer;
-  color: var(--color-base-font);
-  opacity: 0.6;
-  padding: 0 0.25rem;
-  line-height: 1;
+  color: var(--text-secondary);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  font-size: 1.2rem;
+  transition: background 0.15s, color 0.15s;
+}
+
+.settings-popover-close:hover {
+  background: var(--bg-tertiary);
+  color: var(--text-primary);
 }
-.settings-popover-close:hover { opacity: 1; }
 
 .settings-popover-body {
-  padding: 0.8rem;
+  padding: 1rem 1.25rem;
   display: flex;
   flex-direction: column;
-  gap: 1rem;
+  gap: 1.25rem;
 }
 
 .settings-section-title {
   font-size: 0.7rem;
   font-weight: 600;
   text-transform: uppercase;
-  letter-spacing: 0.05em;
-  color: var(--color-suggestion);
-  margin-bottom: 0.5rem;
+  letter-spacing: 0.06em;
+  color: var(--text-muted);
+  margin-bottom: 0.6rem;
 }
 
 /* Theme buttons */
@@ -620,162 +686,109 @@ footer a:hover {
   display: flex;
   gap: 0.4rem;
 }
+
 .theme-btn {
   flex: 1;
-  padding: 0.35rem 0.5rem;
-  border: 1px solid var(--color-sidebar-border);
-  border-radius: var(--radius);
-  background: var(--color-btn-background);
-  color: var(--color-base-font);
+  padding: 0.45rem;
+  border: 1px solid var(--border);
+  border-radius: var(--radius-sm);
+  background: var(--bg);
+  color: var(--text-secondary);
   cursor: pointer;
-  font-size: 0.75rem;
-  text-align: center;
-  transition: background 0.15s, border-color 0.15s;
-}
-.theme-btn:hover { background: var(--color-btn-hover); }
-.theme-btn.active {
-  background: var(--color-link);
-  color: #fff;
-  border-color: var(--color-link);
+  font-size: 0.8rem;
+  font-family: inherit;
+  transition: background 0.15s, border-color 0.15s, color 0.15s;
 }
 
-/* Engine toggles — 2-column grid */
+.theme-btn:hover {
+  background: var(--bg-tertiary);
+}
+
+.theme-btn.active {
+  background: var(--accent-soft);
+  border-color: var(--accent);
+  color: var(--accent);
+  font-weight: 500;
+}
+
+/* Engine toggles */
 .engine-grid {
   display: grid;
   grid-template-columns: 1fr 1fr;
   gap: 0.4rem;
 }
+
 .engine-toggle {
   display: flex;
   align-items: center;
   gap: 0.4rem;
-  padding: 0.3rem 0.5rem;
-  border-radius: var(--radius);
-  background: var(--color-sidebar-background);
-  font-size: 0.78rem;
+  padding: 0.4rem 0.5rem;
+  border-radius: var(--radius-sm);
+  background: var(--bg-tertiary);
+  font-size: 0.8rem;
   cursor: pointer;
+  transition: background 0.1s;
 }
+
+.engine-toggle:hover {
+  background: var(--border);
+}
+
 .engine-toggle input[type="checkbox"] {
   width: 15px;
   height: 15px;
   margin: 0;
   cursor: pointer;
-  accent-color: var(--color-link);
-}
-.engine-toggle span {
-  flex: 1;
-  min-width: 0;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
+  accent-color: var(--accent);
+  flex-shrink: 0;
 }
 
-/* Search defaults */
+.engine-toggle span {
+  color: var(--text-secondary);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+/* Select dropdowns */
 .setting-row {
   display: flex;
   align-items: center;
   justify-content: space-between;
-  gap: 0.5rem;
-  margin-top: 0.4rem;
+  gap: 0.75rem;
 }
+
 .setting-row label {
   font-size: 0.85rem;
-  flex: 1;
+  color: var(--text-secondary);
 }
+
 .setting-row select {
-  width: 110px;
-  padding: 0.3rem 0.4rem;
+  padding: 0.35rem 0.6rem;
   font-size: 0.8rem;
-  border: 1px solid var(--color-sidebar-border);
-  border-radius: var(--radius);
-  background: var(--color-base-background);
-  color: var(--color-base-font);
+  font-family: inherit;
+  border: 1px solid var(--border);
+  border-radius: var(--radius-sm);
+  background: var(--bg);
+  color: var(--text-primary);
   cursor: pointer;
+  min-width: 100px;
+}
+
+.setting-row select:focus {
+  outline: none;
+  border-color: var(--accent);
 }
 
-/* Mid-search notice */
 .settings-notice {
-  font-size: 0.72rem;
-  color: var(--color-suggestion);
-  margin-top: 0.3rem;
+  font-size: 0.75rem;
+  color: var(--text-muted);
   font-style: italic;
+  margin-top: 0.25rem;
 }
 
-/* Dark theme via data-theme attribute */
-html[data-theme="dark"] {
-  --color-base: #222;
-  --color-base-font: #dcdcdc;
-  --color-base-background: #2b2b2b;
-  --color-header-background: #333;
-  --color-header-border: #444;
-  --color-search-border: #555;
-  --color-search-focus: #5dade2;
-  --color-result-url: #8ab4f8;
-  --color-result-url-visited: #b39ddb;
-  --color-result-content: #b0b0b0;
-  --color-result-title: #8ab4f8;
-  --color-result-title-visited: #b39ddb;
-  --color-result-engine: #999;
-  --color-result-border: #3a3a3a;
-  --color-link: #5dade2;
-  --color-link-visited: #b39ddb;
-  --color-sidebar-background: #333;
-  --color-sidebar-border: #444;
-  --color-infobox-background: #333;
-  --color-infobox-border: #444;
-  --color-pagination-current: #5dade2;
-  --color-pagination-border: #444;
-  --color-error: #e74c3c;
-  --color-error-background: #3b1a1a;
-  --color-suggestion: #999;
-  --color-footer: #666;
-  --color-btn-background: #333;
-  --color-btn-border: #555;
-  --color-btn-hover: #444;
-}
-
-/* Light theme via data-theme attribute - explicit reset */
-html[data-theme="light"] {
-  --color-base: #f5f5f5;
-  --color-base-font: #444;
-  --color-base-background: #fff;
-  --color-header-background: #f7f7f7;
-  --color-header-border: #ddd;
-  --color-search-border: #bbb;
-  --color-search-focus: #3498db;
-  --color-result-url: #1a0dab;
-  --color-result-url-visited: #609;
-  --color-result-content: #545454;
-  --color-result-title: #1a0dab;
-  --color-result-title-visited: #609;
-  --color-result-engine: #666;
-  --color-result-border: #eee;
-  --color-link: #3498db;
-  --color-link-visited: #609;
-  --color-sidebar-background: #f7f7f7;
-  --color-sidebar-border: #ddd;
-  --color-infobox-background: #f9f9f9;
-  --color-infobox-border: #ddd;
-  --color-pagination-current: #3498db;
-  --color-pagination-border: #ddd;
-  --color-error: #c0392b;
-  --color-error-background: #fdecea;
-  --color-suggestion: #666;
-  --color-footer: #888;
-  --color-btn-background: #fff;
-  --color-btn-border: #ddd;
-  --color-btn-hover: #eee;
-}
-
-/* Mobile: Bottom sheet + FAB trigger */
-@media (max-width: 768px) {
-  /* Hide desktop trigger, show FAB */
-  .settings-trigger-desktop {
-    display: none;
-  }
-  .settings-trigger-mobile {
-    display: block;
-  }
+/* Mobile settings: bottom sheet */
+@media (max-width: 480px) {
   .settings-popover {
     position: fixed;
     top: auto;
@@ -784,29 +797,64 @@ html[data-theme="light"] {
     right: 0;
     width: 100%;
     max-height: 70vh;
-    border-radius: var(--radius) var(--radius) 0 0;
+    border-radius: var(--radius-lg) var(--radius-lg) 0 0;
     border-bottom: none;
   }
-  /* FAB: fixed bottom-right button visible only on mobile */
+
   .settings-trigger-mobile {
-    display: block;
-    position: fixed;
-    bottom: 1.5rem;
-    right: 1.5rem;
-    width: 48px;
-    height: 48px;
-    border-radius: 50%;
-    background: var(--color-link);
-    color: #fff;
-    border: none;
-    box-shadow: 0 4px 12px rgba(0,0,0,0.2);
-    font-size: 1.2rem;
-    z-index: 199;
-    opacity: 1;
+    display: flex;
   }
 }
 
-/* Video result cards */
+@media (min-width: 481px) {
+  .settings-trigger-mobile {
+    display: none;
+  }
+}
+
+/* ============================================================
+   HTMX Loading State
+   ============================================================ */
+
+.htmx-indicator {
+  display: none;
+  text-align: center;
+  padding: 2rem;
+  color: var(--text-muted);
+}
+
+.htmx-request .htmx-indicator {
+  display: block;
+}
+
+.htmx-request .results-column {
+  opacity: 0.5;
+  transition: opacity 0.2s;
+}
+
+/* ============================================================
+   Back to Top
+   ============================================================ */
+
+.back-to-top {
+  text-align: center;
+  padding: 1rem;
+}
+
+.back-to-top a {
+  color: var(--accent);
+  text-decoration: none;
+  font-size: 0.85rem;
+}
+
+.back-to-top a:hover {
+  text-decoration: underline;
+}
+
+/* ============================================================
+   Video Results
+   ============================================================ */
+
 .video-result {
   display: flex;
   gap: 1rem;
@@ -816,15 +864,134 @@ html[data-theme="light"] {
 .video-result .result_thumbnail {
   flex-shrink: 0;
   width: 180px;
+  border-radius: var(--radius-sm);
+  overflow: hidden;
+  background: var(--bg-tertiary);
 }
 
 .video-result .result_thumbnail img {
   width: 100%;
   height: auto;
-  border-radius: var(--radius);
+  display: block;
+  object-fit: cover;
 }
 
 .video-result .result_content_wrapper {
   flex: 1;
   min-width: 0;
 }
+
+@media (max-width: 480px) {
+  .video-result {
+    flex-direction: column;
+  }
+
+  .video-result .result_thumbnail {
+    width: 100%;
+  }
+}
+
+/* ============================================================
+   Infoboxes
+   ============================================================ */
+
+.infobox {
+  background: var(--bg-secondary);
+  border: 1px solid var(--border);
+  border-radius: var(--radius-md);
+  padding: 1rem;
+  margin-bottom: 0.75rem;
+}
+
+.infobox .title {
+  font-weight: 600;
+  margin-bottom: 0.5rem;
+  font-size: 0.95rem;
+}
+
+.infobox img {
+  max-width: 100%;
+  border-radius: var(--radius-sm);
+  margin-top: 0.5rem;
+}
+
+/* ============================================================
+   Errors
+   ============================================================ */
+
+.dialog-error {
+  background: color-mix(in srgb, var(--accent) 8%, var(--bg));
+  border: 1px solid color-mix(in srgb, var(--accent) 30%, transparent);
+  color: var(--accent);
+  border-radius: var(--radius-md);
+  padding: 0.8rem 1rem;
+  margin-bottom: 1rem;
+  font-size: 0.9rem;
+}
+
+/* ============================================================
+   Focus visible — keyboard navigation
+   ============================================================ */
+
+:focus-visible {
+  outline: 2px solid var(--accent);
+  outline-offset: 2px;
+}
+
+button:focus-visible,
+a:focus-visible {
+  outline: 2px solid var(--accent);
+  outline-offset: 2px;
+}
+
+/* ============================================================
+   Selection color
+   ============================================================ */
+
+::selection {
+  background: var(--accent-soft);
+  color: var(--accent);
+}
+
+/* ============================================================
+   Scrollbar
+   ============================================================ */
+
+::-webkit-scrollbar {
+  width: 8px;
+  height: 8px;
+}
+
+::-webkit-scrollbar-track {
+  background: var(--bg-secondary);
+}
+
+::-webkit-scrollbar-thumb {
+  background: var(--border);
+  border-radius: 4px;
+}
+
+::-webkit-scrollbar-thumb:hover {
+  background: var(--border-focus);
+}
+
+/* ============================================================
+   Print
+   ============================================================ */
+
+@media print {
+  .site-header, footer, .settings-popover, #backToTop, .htmx-indicator, .settings-trigger {
+    display: none !important;
+  }
+
+  body {
+    background: #fff;
+    color: #000;
+  }
+
+  .result {
+    break-inside: avoid;
+    border: 1px solid #ddd;
+    margin-bottom: 1rem;
+  }
+}
diff --git a/internal/views/templates/base.html b/internal/views/templates/base.html
index 239e886..d2fec79 100644
--- a/internal/views/templates/base.html
+++ b/internal/views/templates/base.html
@@ -1,6 +1,6 @@
 {{define "base"}}
 <!DOCTYPE html>
-<html lang="en">
+<html lang="en" data-theme="light">
 <head>
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
@@ -13,31 +13,43 @@
   <link rel="icon" href="/static/img/favicon.svg" type="image/svg+xml">
   <link title="kafka" type="application/opensearchdescription+xml" rel="search" href="/opensearch.xml">
 </head>
-<body class="{{if .Query}}search_on_results{{end}}">
+<body>
   <header class="site-header">
-    <span class="site-title">kafka</span>
-    <!-- Desktop trigger (hidden on mobile via CSS) -->
-    <button id="settings-trigger" class="settings-trigger settings-trigger-desktop"
-      aria-label="Preferences" aria-expanded="false" aria-controls="settings-popover">&#9881;</button>
+    <a href="/" class="site-logo">
+      <svg class="site-logo-mark" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+        <circle cx="11" cy="11" r="8"/>
+        <path d="m21 21-4.35-4.35"/>
+      </svg>
+      <span class="site-name">kafka</span>
+    </a>
+    <button id="settings-trigger" class="settings-trigger" aria-label="Preferences" aria-expanded="false" aria-controls="settings-popover">
+      <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+        <path d="M12.22 2h-.44a2 2 0 0 0-2 2v.18a2 2 0 0 1-1 1.73l-.43.25a2 2 0 0 1-2 0l-.15-.08a2 2 0 0 0-2.73.73l-.22.38a2 2 0 0 0 .73 2.73l.15.1a2 2 0 0 1 1 1.72v.51a2 2 0 0 1-1 1.74l-.15.09a2 2 0 0 0-.73 2.73l.22.38a2 2 0 0 0 2.73.73l.15-.08a2 2 0 0 1 2 0l.43.25a2 2 0 0 1 1 1.73V20a2 2 0 0 0 2 2h.44a2 2 0 0 0 2-2v-.18a2 2 0 0 1 1-1.73l.43-.25a2 2 0 0 1 2 0l.15.08a2 2 0 0 0 2.73-.73l.22-.39a2 2 0 0 0-.73-2.73l-.15-.08a2 2 0 0 1-1-1.74v-.5a2 2 0 0 1 1-1.74l.15-.09a2 2 0 0 0 .73-2.73l-.22-.38a2 2 0 0 0-2.73-.73l-.15.08a2 2 0 0 1-2 0l-.43-.25a2 2 0 0 1-1-1.73V4a2 2 0 0 0-2-2z"/>
+        <circle cx="12" cy="12" r="3"/>
+      </svg>
+    </button>
   </header>
-  <!-- Mobile FAB trigger (shown only on mobile via CSS) -->
-  <button id="settings-trigger-mobile" class="settings-trigger settings-trigger-mobile"
-    aria-label="Preferences" aria-expanded="false" aria-controls="settings-popover"
-    style="display:none;">&#9881;</button>
-  <main>
+
+  <main class="{{if .Query}}page-results{{else}}page-home{{end}}">
     {{template "content" .}}
   </main>
+
   <footer>
-    <p>Powered by <a href="https://git.ashisgreat.xyz/penal-colony/kafka">kafka</a> — a privacy-respecting, open metasearch engine</p>
+    <p>Powered by <a href="https://git.ashisgreat.xyz/penal-colony/kafka">kafka</a> — a privacy-respecting, open metasearch engine{{if .SourceURL}} · <a href="{{.SourceURL}}">Source</a>{{end}} · <a href="https://www.gnu.org/licenses/agpl-3.0.html">AGPLv3</a></p>
   </footer>
+
   <script src="/static/js/settings.js"></script>
+
   <div id="settings-popover" data-open="false" role="dialog" aria-label="Preferences" aria-modal="true">
     <div class="settings-popover-header">
       Preferences
-      <button class="settings-popover-close" aria-label="Close">&#215;</button>
+      <button class="settings-popover-close" aria-label="Close">×</button>
     </div>
     <div class="settings-popover-body"></div>
   </div>
+
+  <div id="autocomplete-dropdown"></div>
+
   <script>
   (function () {
     'use strict';
@@ -50,12 +62,10 @@
     var activeIndex = -1;
     var fetchController = null;
 
-    // Escape regex special chars for highlight matching
     function escapeRegex(str) {
       return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
     }
 
-    // Highlight matching prefix
     function highlight(text, query) {
       if (!query) return text;
       var re = new RegExp('^(' + escapeRegex(query) + ')', 'i');
@@ -72,7 +82,7 @@
         var escaped = highlight(suggestions[i], input.value);
         html += '<div class="autocomplete-suggestion" data-index="' + i + '">' + escaped + '</div>';
       }
-      html += '<div class="autocomplete-footer">Press <kbd>↑</kbd><kbd>↓</kbd> to navigate, Enter to select, Esc to close</div>';
+      html += '<div class="autocomplete-footer">↑↓ navigate · Enter select · Esc close</div>';
       dropdown.innerHTML = html;
       dropdown.classList.add('open');
       activeIndex = -1;
@@ -141,14 +151,13 @@
     });
 
     input.addEventListener('blur', function () {
-      // Delay to allow click events on suggestions
       setTimeout(closeDropdown, 150);
     });
 
     dropdown.addEventListener('mousedown', function (e) {
       var item = e.target.closest('.autocomplete-suggestion');
       if (item) {
-        e.preventDefault(); // prevent blur from firing before select
+        e.preventDefault();
         var idx = parseInt(item.getAttribute('data-index'), 10);
         selectSuggestion(idx);
       }
diff --git a/internal/views/templates/index.html b/internal/views/templates/index.html
index ccf597e..c4d1d57 100644
--- a/internal/views/templates/index.html
+++ b/internal/views/templates/index.html
@@ -1,15 +1,23 @@
 {{define "title"}}{{end}}
 {{define "content"}}
-<div class="index">
-  <div class="title"><h1>kafka</h1></div>
-  <div id="search">
+<div class="search-hero">
+  <div class="hero-logo">
+    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+      <circle cx="11" cy="11" r="8"/>
+      <path d="m21 21-4.35-4.35"/>
+    </svg>
+  </div>
+  <p class="hero-tagline">Search the web privately, without tracking or censorship.</p>
+  <div class="search-box">
     <form method="GET" action="/search" role="search" id="search-form">
-      <input type="text" name="q" id="q" placeholder="Search…" autocomplete="off" autofocus
-        hx-get="/search" hx-target="#results" hx-trigger="keyup changed delay:500ms" hx-include="this">
-      <button type="submit">Search</button>
-      <input type="hidden" name="engines" id="engines-input" value="">
+      <input type="text" name="q" id="q" placeholder="Search the web…" autocomplete="off" autofocus>
+      <button type="submit" class="search-box-submit" aria-label="Search">
+        <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round">
+          <circle cx="11" cy="11" r="8"/>
+          <path d="m21 21-4.35-4.35"/>
+        </svg>
+      </button>
     </form>
-    <div id="autocomplete-dropdown"></div>
   </div>
 </div>
 <div id="results"></div>
diff --git a/internal/views/templates/result_item.html b/internal/views/templates/result_item.html
index 2cbadab..cf1c33b 100644
--- a/internal/views/templates/result_item.html
+++ b/internal/views/templates/result_item.html
@@ -1,16 +1,15 @@
 {{define "result_item"}}
 <article class="result">
-  <h3 class="result_header">
+  <div class="result_header">
     <a href="{{.URL}}" target="_blank" rel="noopener noreferrer">{{.Title}}</a>
-  </h3>
+  </div>
   <div class="result_url">
+    <img class="result-favicon" src="https://www.google.com/s2/favicons?domain={{.URL | urlquery}}&sz=32" alt="" loading="lazy" onerror="this.style.display='none'">
     <a href="{{.URL}}" target="_blank" rel="noopener noreferrer">{{.URL}}</a>
+    <span class="engine-badge">{{.Engine}}</span>
   </div>
   {{if .Content}}
   <p class="result_content">{{.Content}}</p>
   {{end}}
-  {{if .Engine}}
-  <div class="result_engine"><span class="engine">{{.Engine}}</span></div>
-  {{end}}
 </article>
 {{end}}
diff --git a/internal/views/templates/results.html b/internal/views/templates/results.html
index 2a795c3..7010a3a 100644
--- a/internal/views/templates/results.html
+++ b/internal/views/templates/results.html
@@ -1,15 +1,46 @@
 {{define "title"}}{{if .Query}}{{.Query}} — {{end}}{{end}}
 {{define "content"}}
-<div id="search">
-  <form method="GET" action="/search" role="search">
-    <input type="text" name="q" id="q" value="{{.Query}}" autocomplete="off"
-      hx-get="/search" hx-target="#results" hx-trigger="keyup changed delay:500ms" hx-include="this">
-    <button type="submit">Search</button>
-    <input type="hidden" name="engines" id="engines-input" value="">
-  </form>
-</div>
+<div class="results-layout">
+  <!-- Compact search bar -->
+  <div class="search-compact">
+    <div class="search-box">
+      <form method="GET" action="/search" role="search" id="search-form">
+        <input type="text" name="q" id="q" value="{{.Query}}" autocomplete="off" autofocus
+          hx-get="/search" hx-target="#results" hx-trigger="keyup changed delay:500ms" hx-include="this">
+        <button type="submit" class="search-box-submit" aria-label="Search">
+          <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round">
+            <circle cx="11" cy="11" r="8"/>
+            <path d="m21 21-4.35-4.35"/>
+          </svg>
+        </button>
+      </form>
+    </div>
+  </div>
 
-<div id="results">
-  {{template "results_inner" .}}
+  <!-- Results -->
+  <div class="results-column" id="results">
+    {{template "results_inner" .}}
+  </div>
+
+  <!-- Sidebar -->
+  <aside class="sidebar" id="sidebar">
+    {{if .Suggestions}}
+    <div class="sidebar-card">
+      <div class="sidebar-title">Suggestions</div>
+      <div class="suggestion-list">
+        {{range .Suggestions}}<span class="suggestion"><a href="/search?q={{. | urlquery}}">{{.}}</a></span>{{end}}
+      </div>
+    </div>
+    {{end}}
+
+    {{if .UnresponsiveEngines}}
+    <div class="sidebar-card">
+      <div class="sidebar-title">Engines with issues</div>
+      <ul class="unresponsive-engines">
+        {{range .UnresponsiveEngines}}<li>{{index . 0}}: {{index . 1}}</li>{{end}}
+      </ul>
+    </div>
+    {{end}}
+  </aside>
 </div>
 {{end}}
diff --git a/internal/views/templates/results_inner.html b/internal/views/templates/results_inner.html
index 1b93c66..0f9450a 100644
--- a/internal/views/templates/results_inner.html
+++ b/internal/views/templates/results_inner.html
@@ -1,51 +1,26 @@
 {{define "results_inner"}}
 {{if .Corrections}}
-<div class="corrections">
-  {{range .Corrections}}<span class="correction">{{.}}</span>{{end}}
-</div>
+<div class="correction">{{range .Corrections}}{{.}} {{end}}</div>
 {{end}}
 
-{{if .Answers}}
+{{if or .Answers .Infoboxes}}
 <div id="answers">
   {{range .Answers}}
-  <div class="answer">{{.}}</div>
+  <div class="dialog-error">{{.}}</div>
+  {{end}}
+  {{range .Infoboxes}}
+  <div class="infobox">
+    {{if .title}}<div class="title">{{.title}}</div>{{end}}
+    {{if .content}}<div>{{.content}}</div>{{end}}
+    {{if .img_src}}<img src="{{.img_src}}" alt="{{.title}}">{{end}}
+  </div>
   {{end}}
 </div>
 {{end}}
 
-<div id="sidebar">
+<div class="results-meta">
   {{if .NumberOfResults}}
-  <p id="result_count"><small>{{.NumberOfResults}} results</small></p>
-  {{end}}
-
-  {{if .Infoboxes}}
-  <div id="infoboxes">
-    {{range .Infoboxes}}
-    <div class="infobox">
-      {{if .title}}<div class="title">{{.title}}</div>{{end}}
-      {{if .content}}<div class="content">{{.content}}</div>{{end}}
-      {{if .img_src}}<img src="{{.img_src}}" alt="{{.title}}" loading="lazy">{{end}}
-    </div>
-    {{end}}
-  </div>
-  {{end}}
-
-  {{if .Suggestions}}
-  <div id="suggestions">
-    <small>Suggestions:</small>
-    <div>
-      {{range .Suggestions}}<span class="suggestion"><a href="/search?q={{.}}">{{.}}</a></span>{{end}}
-    </div>
-  </div>
-  {{end}}
-
-  {{if .UnresponsiveEngines}}
-  <div class="unresponsive_engines">
-    <small>Unresponsive engines:</small>
-    <ul>
-      {{range .UnresponsiveEngines}}<li>{{index . 0}}: {{index . 1}}</li>{{end}}
-    </ul>
-  </div>
+  <span>{{.NumberOfResults}} results</span>
   {{end}}
 </div>
 
@@ -59,51 +34,47 @@
   {{end}}
   {{end}}
   {{else if not .Answers}}
-  <div class="no_results">
-    <p>No results found.</p>
-    {{if .Query}}<p>Try different keywords or check your spelling.</p>{{end}}
+  <div class="no-results">
+    <div class="no-results-icon">🔍</div>
+    <h2>No results found</h2>
+    <p>Try different keywords or check your spelling.</p>
   </div>
   {{end}}
 </div>
 
 {{if .Pageno}}
-<nav id="pagination" role="navigation">
+<nav class="pagination" role="navigation">
   {{if gt .Pageno 1}}
-  <form method="GET" action="/search" class="previous_page">
+  <form method="GET" action="/search" class="prev-next">
     <input type="hidden" name="q" value="{{.Query}}">
     <input type="hidden" name="pageno" value="{{.PrevPage}}">
-    <input type="hidden" name="format" value="html">
-    <button type="submit" role="link">← Previous</button>
+    <button type="submit">← Prev</button>
   </form>
   {{end}}
 
-  <div class="numbered_pagination">
-    {{range .PageNumbers}}
-    {{if .IsCurrent}}
-    <span class="page_number_current">{{.Num}}</span>
-    {{else}}
-    <form method="GET" action="/search" class="page_number">
-      <input type="hidden" name="q" value="{{$.Query}}">
-      <input type="hidden" name="pageno" value="{{.Num}}">
-      <input type="hidden" name="format" value="html">
-      <button type="submit" role="link">{{.Num}}</button>
-    </form>
-    {{end}}
-    {{end}}
-  </div>
+  {{range .PageNumbers}}
+  {{if .IsCurrent}}
+  <span class="page-current">{{.Num}}</span>
+  {{else}}
+  <form method="GET" action="/search" class="page-link">
+    <input type="hidden" name="q" value="{{$.Query}}">
+    <input type="hidden" name="pageno" value="{{.Num}}">
+    <button type="submit">{{.Num}}</button>
+  </form>
+  {{end}}
+  {{end}}
 
   {{if .HasNext}}
-  <form method="GET" action="/search" class="next_page">
+  <form method="GET" action="/search" class="prev-next">
     <input type="hidden" name="q" value="{{.Query}}">
     <input type="hidden" name="pageno" value="{{.NextPage}}">
-    <input type="hidden" name="format" value="html">
-    <button type="submit" role="link">Next →</button>
+    <button type="submit">Next →</button>
   </form>
   {{end}}
 </nav>
 {{end}}
 
-<div id="backToTop">
+<div class="back-to-top" id="backToTop">
   <a href="#">↑ Back to top</a>
 </div>
 
diff --git a/internal/views/templates/video_item.html b/internal/views/templates/video_item.html
index 0ca0109..b94c061 100644
--- a/internal/views/templates/video_item.html
+++ b/internal/views/templates/video_item.html
@@ -8,15 +8,15 @@
   </div>
   {{end}}
   <div class="result_content_wrapper">
-    <h3 class="result_header">
+    <div class="result_header">
       <a href="{{.URL}}" target="_blank" rel="noopener noreferrer">{{.Title}}</a>
-    </h3>
+    </div>
+    <div class="result_url">
+      <span class="engine-badge">youtube</span>
+    </div>
     {{if .Content}}
     <p class="result_content">{{.Content}}</p>
     {{end}}
-    {{if .Engine}}
-    <div class="result_engine"><span class="engine">{{.Engine}}</span></div>
-    {{end}}
   </div>
 </article>
 {{end}}
diff --git a/internal/views/views.go b/internal/views/views.go
index 58ef2eb..4d7289c 100644
--- a/internal/views/views.go
+++ b/internal/views/views.go
@@ -1,3 +1,19 @@
+// kafka — a privacy-respecting metasearch engine
+// Copyright (C) 2026-present metamorphosis-dev
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
 package views
 
 import (
@@ -19,6 +35,7 @@ var staticFS embed.FS
 
 // PageData holds all data passed to templates.
 type PageData struct {
+	SourceURL           string
 	Query               string
 	Pageno              int
 	PrevPage            int
@@ -171,9 +188,9 @@ func FromResponse(resp contracts.SearchResponse, query string, pageno int) PageD
 }
 
 // RenderIndex renders the homepage (search box only).
-func RenderIndex(w http.ResponseWriter) error {
+func RenderIndex(w http.ResponseWriter, sourceURL string) error {
 	w.Header().Set("Content-Type", "text/html; charset=utf-8")
-	return tmplIndex.ExecuteTemplate(w, "base", PageData{ShowHeader: true})
+	return tmplIndex.ExecuteTemplate(w, "base", PageData{ShowHeader: true, SourceURL: sourceURL})
 }
 
 // RenderSearch renders the full search results page (with base layout).