@@ -0,0 +1,53 @@
+name: Templates end-to-end tests
+
+on:
+  workflow_dispatch:
+    secrets:
+      APIFY_TEST_USER_API_TOKEN:
+        description: API token of the Python testing user on Apify
+        required: true
+
+jobs:
+  end_to_end_tests:
+    name: End-to-end tests
+    strategy:
+      fail-fast: false
+
+    runs-on: "ubuntu-latest"
+    env:
+      python-version: "3.13"
+      node-version: "22"
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup node
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ env.node-version }}
+
+      - name: Install dependencies
+        run: npm install -g apify-cli
+
+      - name: Set up Python ${{ env.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ env.python-version }}
+
+      # installed to be able to patch crawlee in the poetry.lock with custom wheel file for poetry based templates
+      - name: Install poetry
+        run: pipx install poetry
+
+      - name: Set up uv package manager
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ env.python-version }}
+
+      - name: Install Python dependencies
+        run: make install-dev
+
+      - name: Run templates end-to-end tests
+        run: make e2e-templates-tests
+        env:
+          APIFY_TEST_USER_API_TOKEN: ${{ secrets.APIFY_TEST_USER_API_TOKEN }}
@@ -72,13 +72,19 @@ To run unit tests with HTML coverage report:
 make unit-tests-cov
 ```
 
-<!--
-TODO:
+## End-to-end tests
 
-## Integration tests
+Pre-requisites for running end-to-end tests:
+ - [apify-cli](https://docs.apify.com/cli/docs/installation) correctly installed
+ - `apify-cli` available in `PATH` environment variable
+ - Your [apify token](https://docs.apify.com/platform/integrations/api#api-token) is available in `APIFY_TEST_USER_API_TOKEN` environment variable
 
-...
--->
+
+To run end-to-end tests:
+
+```sh
+make e2e-templates-tests
+```
 
 ## Documentation
 
 
@@ -2,7 +2,7 @@
 	integration-tests format check-code build-api-reference run-docs
 
 # This is default for local testing, but GitHub workflows override it to a higher value in CI
-INTEGRATION_TESTS_CONCURRENCY = 1
+E2E_TESTS_CONCURRENCY = 1
 
 clean:
 	rm -rf .mypy_cache .pytest_cache .ruff_cache build dist htmlcov .coverage
@@ -32,8 +32,8 @@ unit-tests:
 unit-tests-cov:
 	uv run pytest --numprocesses=auto --verbose --cov=src/crawlee --cov-report=html tests/unit
 
-integration-tests:
-	uv run pytest --numprocesses=$(INTEGRATION_TESTS_CONCURRENCY) --verbose tests/integration
+e2e-templates-tests:
+	uv run pytest --numprocesses=$(E2E_TESTS_CONCURRENCY) --verbose tests/e2e/project_template
 
 format:
 	uv run ruff check --fix
 
@@ -92,6 +92,8 @@ crawlee = "crawlee._cli:cli"
 
 [dependency-groups]
 dev = [
+    "apify_client",  # For e2e tests.
+    "build~=1.2.2",  # For e2e tests.
     "mypy~=1.15.0",
     "pre-commit~=4.2.0",
     "proxy-py~=2.4.0",
@@ -119,7 +121,7 @@ packages = ["src/crawlee"]
 [tool.ruff]
 line-length = 120
 include = ["src/**/*.py", "tests/**/*.py", "docs/**/*.py", "website/**/*.py"]
-extend-exclude = ["project_template"]
+extend-exclude = ["src/crawlee/project_template"]
 
 [tool.ruff.lint]
 select = ["ALL"]
@@ -207,7 +209,7 @@ timeout = 1200
 [tool.mypy]
 python_version = "3.9"
 plugins = ["pydantic.mypy"]
-exclude = ["project_template"]
+exclude = ["src/crawlee/project_template"]
 files = ["src", "tests", "docs", "website"]
 check_untyped_defs = true
 disallow_incomplete_defs = true
@@ -229,6 +231,8 @@ module = [
     "jaro",                         # Untyped and stubs not available
     "loguru",                       # Example code shows integration of loguru and crawlee for JSON logging.
     "sklearn.linear_model",         # Untyped and stubs not available
+    "cookiecutter.*",               # Untyped and stubs not available
+    "inquirer.*",                   # Untyped and stubs not available
 ]
 ignore_missing_imports = true
 
 
@@ -7,10 +7,10 @@
 from typing import Annotated, Optional, cast
 
 try:
-    import inquirer  # type: ignore[import-untyped]
+    import inquirer
     import typer
-    from cookiecutter.main import cookiecutter  # type: ignore[import-untyped]
-    from inquirer.render.console import ConsoleRender  # type: ignore[import-untyped]
+    from cookiecutter.main import cookiecutter
+    from inquirer.render.console import ConsoleRender
     from rich.progress import Progress, SpinnerColumn, TextColumn
 except ModuleNotFoundError as exc:
     raise ImportError(
@@ -21,7 +21,8 @@
 cli = typer.Typer(no_args_is_help=True)
 
 template_directory = importlib.resources.files('crawlee') / 'project_template'
-cookiecutter_json = json.load((template_directory / 'cookiecutter.json').open())
+with open(str(template_directory / 'cookiecutter.json')) as f:
+    cookiecutter_json = json.load(f)
 
 crawler_choices = cookiecutter_json['crawler_type']
 http_client_choices = cookiecutter_json['http_client']
 
@@ -2,7 +2,6 @@
 import subprocess
 from pathlib import Path
 
-Path('_pyproject.toml').rename('pyproject.toml')
 
 # % if cookiecutter.package_manager in ['poetry', 'uv']
 Path('requirements.txt').unlink()
 
@@ -20,8 +20,7 @@ RUN pip install -U pip setuptools \
 # Second, copy just poetry.lock and pyproject.toml into the Actor image,
 # since those should be the only files that affects the dependency install in the next step,
 # in order to speed up the build
-COPY pyproject.toml ./
-COPY poetry.lock ./
+COPY pyproject.toml poetry.lock ./
 
 # Install the dependencies
 RUN echo "Python version:" \
 
@@ -0,0 +1,44 @@
+import subprocess
+from pathlib import Path
+
+import pytest
+from filelock import FileLock
+
+_CRAWLEE_ROOT_PATH = Path(__file__).parent.parent.parent.resolve()
+
+
+@pytest.fixture(scope='session')
+def crawlee_wheel_path(tmp_path_factory: pytest.TempPathFactory, testrun_uid: str) -> Path:
+    """Build the package wheel if it hasn't been built yet, and return the path to the wheel."""
+    # Make sure the wheel is not being built concurrently across all the pytest-xdist runners,
+    # through locking the building process with a temp file.
+    with FileLock(tmp_path_factory.getbasetemp().parent / 'crawlee_wheel_build.lock'):
+        # Make sure the wheel is built exactly once across all the pytest-xdist runners,
+        # through an indicator file saying that the wheel was already built.
+        was_wheel_built_this_test_run_file = tmp_path_factory.getbasetemp() / f'wheel_was_built_in_run_{testrun_uid}'
+        if not was_wheel_built_this_test_run_file.exists():
+            subprocess.run(
+                args='python -m build',
+                cwd=_CRAWLEE_ROOT_PATH,
+                shell=True,
+                check=True,
+                capture_output=True,
+            )
+            was_wheel_built_this_test_run_file.touch()
+
+        # Read the current package version, necessary for getting the right wheel filename.
+        pyproject_toml_file = (_CRAWLEE_ROOT_PATH / 'pyproject.toml').read_text(encoding='utf-8')
+        for line in pyproject_toml_file.splitlines():
+            if line.startswith('version = '):
+                delim = '"' if '"' in line else "'"
+                crawlee_version = line.split(delim)[1]
+                break
+        else:
+            raise RuntimeError('Unable to find version string.')
+
+        wheel_path = _CRAWLEE_ROOT_PATH / 'dist' / f'crawlee-{crawlee_version}-py3-none-any.whl'
+
+        # Just to be sure.
+        assert wheel_path.exists()
+
+        return wheel_path