commit e566ab70fcaa852e7e985e087aa96e4881f4238e
Author: Ivan Nikolskiy <enty8080@gmail.com>
Date:   Thu Jul 3 16:35:08 2025 +0200

    Init

diff --git a/LICENSE b/LICENSE
new file mode 100755
index 0000000..d64a124
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Hopsenn
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.
\ No newline at end of file
diff --git a/MANIFEST.in b/MANIFEST.in
new file mode 100755
index 0000000..606d973
--- /dev/null
+++ b/MANIFEST.in
@@ -0,0 +1,3 @@
+include README.md
+include LICENSE
+recursive-include django_hopcdn/templatetags *.py
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100755
index 0000000..a4f6f19
--- /dev/null
+++ b/README.md
@@ -0,0 +1,122 @@
+# HopCDN Client for Django
+
+**django-hopcdn** is a lightweight Django library that simplifies loading CSS frameworks from your own CDN. It reads a manifest file served by the CDN to resolve the correct hashed filenames and generates `<link>` tags using a simple template tag.
+
+---
+
+## 📚 Table of Contents
+
+* [✅ Features](#✅-features)
+
+* [🛠️ Installation](#🛠️-installation)
+
+* [🚀 Quick Start](#🚀-quick-start)
+
+  * [1. Configure settings](#1-configure-settings)
+  * [2. Use the template tag](#2-use-the-template-tag)
+
+* [⚙️ Notes & Behavior](#⚙️-notes--behavior)
+
+* [📄 License](#📄-license)
+
+---
+
+## ✅ Features
+
+* 📦 Loads hashed/minified CSS from your CDN using a manifest
+* 🚀 Simple `{% hopcdn_stylesheet 'name' %}` tag for easy integration
+* ⚡ In-memory caching for performance (thread-safe)
+* 🛠️ Fallback-safe if manifest is missing or incomplete
+* 🧱 Easy to extend or override
+
+---
+
+## 🛠️ Installation
+
+```bash
+pip install django-hopcdn
+```
+
+Add to `INSTALLED_APPS`:
+
+```python
+INSTALLED_APPS = [
+    ...,
+    'django_hopcdn',
+]
+```
+
+---
+
+## 🚀 Quick Start
+
+### 1. Configure settings
+
+Add the CDN base URL in your `settings.py`:
+
+```python
+CDN_URL = "https://cdn.hopsenn.com/"
+```
+
+Your CDN must expose a `manifest.json` at:
+
+```
+https://cdn.hopsenn.com/manifest.json
+```
+
+Example `manifest.json`:
+
+```json
+{
+  "main": "main.ab12cd.css",
+  "theme": "theme.f8d33e.css"
+}
+```
+
+### 2. Use the template tag
+
+In your template:
+
+```django
+{% load hopcdn_tags %}
+{% hopcdn_stylesheet 'main' %}
+{% hopcdn_stylesheet 'theme' %}
+```
+
+This will render:
+
+```html
+<link rel="stylesheet" href="https://cdn.hopsenn.com/styles/main/main.ab12cd.css">
+<link rel="stylesheet" href="https://cdn.hopsenn.com/styles/theme/theme.f8d33e.css">
+```
+
+---
+
+## ⚙️ Notes & Behavior
+
+* The manifest is fetched only once per server process and cached in memory.
+
+* If a key is missing or the CDN is unreachable, the tag will output a helpful comment like:
+
+  ```html
+  <!-- hopcdn: 'main' not found in manifest -->
+  ```
+
+* The expected file structure on your CDN is:
+
+  ```
+  /manifest.json
+  /styles/<name>/<filename-from-manifest>
+  ```
+
+---
+
+## 📄 License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome! Open issues or pull requests on [Git](https://git.hopsenn.com/hopsenn/django-hopcdn).
diff --git a/django_hopcdn/__init__.py b/django_hopcdn/__init__.py
new file mode 100755
index 0000000..8699746
--- /dev/null
+++ b/django_hopcdn/__init__.py
@@ -0,0 +1,23 @@
+"""
+MIT License
+
+Copyright (c) 2025 Hopsenn
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.
+"""
\ No newline at end of file
diff --git a/django_hopcdn/settings.py b/django_hopcdn/settings.py
new file mode 100755
index 0000000..bdf9768
--- /dev/null
+++ b/django_hopcdn/settings.py
@@ -0,0 +1,32 @@
+"""
+MIT License
+
+Copyright (c) 2025 Hopsenn
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.
+"""
+
+from django.conf import settings
+
+def get(key, default=None):
+    return getattr(settings, key, default)
+
+CDN_URL = get('CDN_URL', 'https://cdn.hopsenn.com/')
+
+DEBUG = get('DEBUG', False)
diff --git a/django_hopcdn/templatetags/__init__.py b/django_hopcdn/templatetags/__init__.py
new file mode 100755
index 0000000..8699746
--- /dev/null
+++ b/django_hopcdn/templatetags/__init__.py
@@ -0,0 +1,23 @@
+"""
+MIT License
+
+Copyright (c) 2025 Hopsenn
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.
+"""
\ No newline at end of file
diff --git a/django_hopcdn/templatetags/hopcdn_tags.py b/django_hopcdn/templatetags/hopcdn_tags.py
new file mode 100755
index 0000000..55942d1
--- /dev/null
+++ b/django_hopcdn/templatetags/hopcdn_tags.py
@@ -0,0 +1,70 @@
+from django import template
+from django.conf import settings
+
+"""
+MIT License
+
+Copyright (c) 2025 Hopsenn
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.
+"""
+
+import json
+import threading
+import urllib.request
+
+from django import template
+from django.utils.safestring import mark_safe
+
+from django_hopcdn.settings import CDN_URL
+
+register = template.Library()
+
+_manifest_cache = {}
+_lock = threading.Lock()
+
+
+def get_manifest():
+    cdn_url = CDN_URL.rstrip('/')
+    manifest_url = f"{cdn_url}/manifest.json"
+
+    with _lock:
+        if not _manifest_cache:
+            try:
+                with urllib.request.urlopen(manifest_url) as response:
+                    _manifest_cache.update(json.loads(response.read().decode()))
+            except Exception:
+                # Log or handle as needed
+                return {}
+        return _manifest_cache
+
+
+@register.simple_tag
+def hopcdn_stylesheet(name):
+    manifest = get_manifest()
+    print(manifest)
+    filename = manifest.get(name)
+
+    if not filename:
+        return f"<!-- hopcdn: '{name}' not found in manifest -->"
+
+    cdn_url = CDN_URL.rstrip('/')
+    href = f"{cdn_url}/styles/{name}/{filename}"
+    return mark_safe(f'<link rel="stylesheet" href="{href}">')
+
diff --git a/example/demoapp/demoapp/__init__.py b/example/demoapp/demoapp/__init__.py
new file mode 100755
index 0000000..8699746
--- /dev/null
+++ b/example/demoapp/demoapp/__init__.py
@@ -0,0 +1,23 @@
+"""
+MIT License
+
+Copyright (c) 2025 Hopsenn
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.
+"""
\ No newline at end of file
diff --git a/example/demoapp/demoapp/asgi.py b/example/demoapp/demoapp/asgi.py
new file mode 100755
index 0000000..0c7bd2a
--- /dev/null
+++ b/example/demoapp/demoapp/asgi.py
@@ -0,0 +1,31 @@
+"""
+MIT License
+
+Copyright (c) 2025 Hopsenn
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.
+"""
+
+import os
+
+from django.core.asgi import get_asgi_application
+
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'demoapp.settings')
+
+application = get_asgi_application()
diff --git a/example/demoapp/demoapp/settings.py b/example/demoapp/demoapp/settings.py
new file mode 100755
index 0000000..427ba9b
--- /dev/null
+++ b/example/demoapp/demoapp/settings.py
@@ -0,0 +1,136 @@
+"""
+MIT License
+
+Copyright (c) 2025 Hopsenn
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.
+"""
+
+from pathlib import Path
+
+# Build paths inside the project like this: BASE_DIR / 'subdir'.
+BASE_DIR = Path(__file__).resolve().parent.parent
+
+
+# Quick-start development settings - unsuitable for production
+# See https://docs.djangoproject.com/en/5.2/howto/deployment/checklist/
+
+# SECURITY WARNING: keep the secret key used in production secret!
+SECRET_KEY = 'django-insecure-jv__th8%4!0ite+vhv%c@(q$1=n8xwg(46@k3zbz7^oeq-+)p&'
+
+# SECURITY WARNING: don't run with debug turned on in production!
+DEBUG = True
+
+ALLOWED_HOSTS = []
+
+
+# Application definition
+
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    'django_hopcdn'
+]
+
+MIDDLEWARE = [
+    'django.middleware.security.SecurityMiddleware',
+    'django.contrib.sessions.middleware.SessionMiddleware',
+    'django.middleware.common.CommonMiddleware',
+    'django.middleware.csrf.CsrfViewMiddleware',
+    'django.contrib.auth.middleware.AuthenticationMiddleware',
+    'django.contrib.messages.middleware.MessageMiddleware',
+    'django.middleware.clickjacking.XFrameOptionsMiddleware',
+]
+
+ROOT_URLCONF = 'demoapp.urls'
+
+TEMPLATES = [
+    {
+        'BACKEND': 'django.template.backends.django.DjangoTemplates',
+        'DIRS': [BASE_DIR / 'demoapp'],
+        'APP_DIRS': True,
+        'OPTIONS': {
+            'context_processors': [
+                'django.template.context_processors.request',
+                'django.contrib.auth.context_processors.auth',
+                'django.contrib.messages.context_processors.messages',
+            ],
+        },
+    },
+]
+
+WSGI_APPLICATION = 'demoapp.wsgi.application'
+
+
+# Database
+# https://docs.djangoproject.com/en/5.2/ref/settings/#databases
+
+DATABASES = {
+    'default': {
+        'ENGINE': 'django.db.backends.sqlite3',
+        'NAME': BASE_DIR / 'db.sqlite3',
+    }
+}
+
+
+# Password validation
+# https://docs.djangoproject.com/en/5.2/ref/settings/#auth-password-validators
+
+AUTH_PASSWORD_VALIDATORS = [
+    {
+        'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',
+    },
+]
+
+
+# Internationalization
+# https://docs.djangoproject.com/en/5.2/topics/i18n/
+
+LANGUAGE_CODE = 'en-us'
+
+TIME_ZONE = 'UTC'
+
+USE_I18N = True
+
+USE_TZ = True
+
+
+# Static files (CSS, JavaScript, Images)
+# https://docs.djangoproject.com/en/5.2/howto/static-files/
+
+STATIC_URL = 'static/'
+STATIC_ROOT = BASE_DIR / 'staticfiles'
+
+# Default primary key field type
+# https://docs.djangoproject.com/en/5.2/ref/settings/#default-auto-field
+
+DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'
diff --git a/example/demoapp/demoapp/templates/index.html b/example/demoapp/demoapp/templates/index.html
new file mode 100755
index 0000000..4c4b777
--- /dev/null
+++ b/example/demoapp/demoapp/templates/index.html
@@ -0,0 +1,61 @@
+{% load hopcdn_tags %}
+
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+
+    <meta name="description" content="Ranters">
+    <meta name="author" content="Hopsenn">
+
+    <title>
+        Test
+    </title>
+    <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" crossorigin="anonymous">
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css">
+    {% hopcdn_stylesheet 'hopsenn' %}
+</head>
+<body>
+<div class="home-container">
+    <!-- Header with Search, Filter & Theme Toggle -->
+    <div class="home-header">
+        <div class="header-inner">
+            <!-- Filter Button (Replaces Home Button) -->
+            <button id="filterToggle" class="filter-toggle">
+                <i class="fa fa-filter"></i>
+            </button>
+            <input type="text" id="searchMessages" class="form-control" placeholder="Search messages..." />
+            <button id="themeToggle" class="theme-toggle">
+                <i class="fa fa-moon-o"></i>
+            </button>
+        </div>
+        <div class="board-selection-container" id="filterSelection" style="display: none;"></div>
+    </div>
+
+    <!-- Go Up Button -->
+    <button id="goUpButton" class="send-button go-up-btn">
+        <i class="fa fa-arrow-up"></i>
+    </button>
+
+    <!-- Messages Container -->
+    <div class="home-body" id="messagesContainer">
+        <!-- Messages will be dynamically added here -->
+    </div>
+
+    <!-- Chat Input -->
+    <div class="home-input">
+        <div class="board-selection-container" id="boardSelection"></div> <!-- Boards appear here -->
+
+        <div class="d-flex align-items-end">
+            <textarea id="messageInput" class="form-control" placeholder="Type a message..." style="flex: 1;"></textarea>
+            <button class="send-button">
+                <i class="fa fa-arrow-up"></i>
+            </button>
+        </div>
+    </div>
+
+    <p class="footer-text">Made by <a href="https://www.linkedin.com/in/ivan-nikolskiy/">Ivan</a> & <a href="https://www.linkedin.com/in/mngrf">Myroslav</a></p>
+</div>
+</body>
+</html>
\ No newline at end of file
diff --git a/example/demoapp/demoapp/urls.py b/example/demoapp/demoapp/urls.py
new file mode 100755
index 0000000..91d475a
--- /dev/null
+++ b/example/demoapp/demoapp/urls.py
@@ -0,0 +1,38 @@
+"""
+MIT License
+
+Copyright (c) 2025 Hopsenn
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.
+"""
+
+from django.contrib import admin
+from django.urls import path
+from django.conf import settings
+from django.conf.urls.static import static
+
+from . import views
+
+urlpatterns = [
+    path('admin/', admin.site.urls),
+    path('', views.index, name='index'),
+]
+
+if settings.DEBUG:
+    urlpatterns += static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
\ No newline at end of file
diff --git a/example/demoapp/demoapp/views.py b/example/demoapp/demoapp/views.py
new file mode 100755
index 0000000..dcb99c7
--- /dev/null
+++ b/example/demoapp/demoapp/views.py
@@ -0,0 +1,29 @@
+"""
+MIT License
+
+Copyright (c) 2025 Hopsenn
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.
+"""
+
+from django.shortcuts import render
+
+
+def index(request):
+    return render(request, "templates/index.html")
diff --git a/example/demoapp/demoapp/wsgi.py b/example/demoapp/demoapp/wsgi.py
new file mode 100755
index 0000000..c622109
--- /dev/null
+++ b/example/demoapp/demoapp/wsgi.py
@@ -0,0 +1,31 @@
+"""
+MIT License
+
+Copyright (c) 2025 Hopsenn
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.
+"""
+
+import os
+
+from django.core.wsgi import get_wsgi_application
+
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'demoapp.settings')
+
+application = get_wsgi_application()
diff --git a/example/demoapp/manage.py b/example/demoapp/manage.py
new file mode 100755
index 0000000..a3c2886
--- /dev/null
+++ b/example/demoapp/manage.py
@@ -0,0 +1,44 @@
+"""
+MIT License
+
+Copyright (c) 2025 Hopsenn
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.
+"""
+
+import os
+import sys
+
+
+def main():
+    """Run administrative tasks."""
+    os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'demoapp.settings')
+    try:
+        from django.core.management import execute_from_command_line
+    except ImportError as exc:
+        raise ImportError(
+            "Couldn't import Django. Are you sure it's installed and "
+            "available on your PYTHONPATH environment variable? Did you "
+            "forget to activate a virtual environment?"
+        ) from exc
+    execute_from_command_line(sys.argv)
+
+
+if __name__ == '__main__':
+    main()
diff --git a/setup.py b/setup.py
new file mode 100755
index 0000000..3756322
--- /dev/null
+++ b/setup.py
@@ -0,0 +1,49 @@
+"""
+MIT License
+
+Copyright (c) 2025 Hopsenn
+
+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:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.
+"""
+
+from setuptools import setup, find_packages
+
+setup(
+    name='django-hopcdn',
+    version='1.0.0',
+    description='Django client integration for the HopCDN provider',
+    author='Hopsenn',
+    author_email='ivan.nikolskiy@hopsenn.com',
+    url='https://git.hopsenn.com/hopsenn/django-hopcdn',
+    packages=find_packages(),
+    include_package_data=True,
+    install_requires=[
+        'requests>=2.20',
+        'Django>=3.2'
+    ],
+    classifiers=[
+        'Development Status :: 4 - Beta',
+        'Framework :: Django',
+        'Intended Audience :: Developers',
+        'License :: OSI Approved :: MIT License',
+        'Operating System :: OS Independent',
+        'Programming Language :: Python :: 3',
+    ],
+    python_requires='>=3.6',
+)