@@ -4,11 +4,11 @@
 
 - TODO
 
-### Related issues
+### Issues
 
 <!-- If applicable, reference any related GitHub issues -->
 
-- TODO
+- Closes: #TODO
 
 ### Testing
 
 
@@ -1,11 +1,15 @@
 # Changelog
 
-## [0.0.8](../../releases/tag/v0.0.8) - Unreleased
+## [0.1.0](../../releases/tag/v0.1.0) - Unreleased
 
 ### Adds
 
 - new project bootstrapping via `pipx run crawlee create`
 
+### Fixes
+
+- improve error handling in project bootstrapping
+
 ## [0.0.7](../../releases/tag/v0.0.7) - 2024-06-27
 
 ### Fixes
 
@@ -12,15 +12,15 @@ We use [Poetry](https://python-poetry.org/) for project management. Install it a
 
 To install this package and its development dependencies, run:
 
-```bash
+```sh
 make install-dev
 ```
 
 ## Code checking
 
 To execute all code checking tools together, run:
 
-```bash
+```sh
 make check-code
 ```
 
@@ -30,7 +30,7 @@ We utilize [ruff](https://docs.astral.sh/ruff/) for linting, which analyzes code
 
 To run linting:
 
-```bash
+```sh
 make lint
 ```
 
@@ -40,7 +40,7 @@ Our automated code formatting also leverages [ruff](https://docs.astral.sh/ruff/
 
 To run formatting:
 
-```bash
+```sh
 make format
 ```
 
@@ -50,7 +50,7 @@ Type checking is handled by [mypy](https://mypy.readthedocs.io/), verifying code
 
 To run type checking:
 
-```bash
+```sh
 make type-check
 ```
 
@@ -62,13 +62,13 @@ We use [pytest](https://docs.pytest.org/) as a testing framework with many plugi
 
 To run unit tests:
 
-```bash
+```sh
 make unit-tests
 ```
 
 To run unit tests with HTML coverage report:
 
-```bash
+```sh
 make unit-tests-cov
 ```
 
@@ -90,25 +90,25 @@ To run the documentation locally, you need to have Node.js version 20 or higher
 
 Navigate to the `website/` directory:
 
-```bash
+```sh
 cd website/
 ```
 
 Enable Corepack, which installs Yarn automatically:
 
-```bash
+```sh
 corepack enable
 ```
 
 Install the necessary dependencies:
 
-```bash
+```sh
 yarn
 ```
 
 Start the project in development mode with Hot Module Replacement (HMR):
 
-```bash
+```sh
 yarn start
 ```
 
 
@@ -11,7 +11,7 @@
 
 Crawlee covers your crawling and scraping end-to-end and **helps you build reliable scrapers. Fast.**
 
-Your crawlers will appear almost human-like and fly under the radar of modern bot protections even with the default configuration. Crawlee gives you the tools to crawl the web for links, scrape data, and store it to disk or cloud while staying configurable to suit your project's needs.
+Your crawlers will appear almost human-like and fly under the radar of modern bot protections even with the default configuration. Crawlee gives you the tools to crawl the web for links, scrape data and persistently store it in machine-readable formats, without having to worry about the technical details. And thanks to rich configuration options, you can tweak almost any aspect of Crawlee to suit your project's needs if the default settings don't cut it.
 
 > 👉 **View full documentation, guides and examples on the [Crawlee project website](https://crawlee.dev/python/)** 👈
 
@@ -23,64 +23,53 @@ We recommend visiting the [Introduction tutorial](https://crawlee.dev/python/doc
 
 Crawlee is available as the [`crawlee`](https://pypi.org/project/crawlee/) PyPI package.
 
-```bash
+```sh
 pip install crawlee
 ```
 
 Additional, optional dependencies unlocking more features are shipped as package extras.
 
 If you plan to use `BeautifulSoupCrawler`, install `crawlee` with `beautifulsoup` extra:
 
-```bash
+```sh
 pip install 'crawlee[beautifulsoup]'
 ```
 
 If you plan to use `PlaywrightCrawler`, install `crawlee` with the `playwright` extra:
 
-```bash
+```sh
 pip install 'crawlee[playwright]'
 ```
 
 Then, install the Playwright dependencies:
 
-```bash
+```sh
 playwright install
 ```
 
 You can install multiple extras at once by using a comma as a separator:
 
-```bash
+```sh
 pip install 'crawlee[beautifulsoup,playwright]'
 ```
 
-## Features
-
-Why Crawlee is the preferred choice for web scraping and crawling?
+### With Crawlee CLI
 
-### Why use Crawlee instead of just a random HTTP library with an HTML parser?
-
-- Unified interface for **HTTP & headless browser** crawling.
-- Automatic **parallel crawling** based on available system resources.
-- Written in Python with **type hints** - enhances DX (IDE autocompletion) and reduces bugs (static type checking).
-- Automatic **retries** on errors or when you’re getting blocked.
-- Integrated **proxy rotation** and session management.
-- Configurable **request routing** - direct URLs to the appropriate handlers.
-- Persistent **queue for URLs** to crawl.
-- Pluggable **storage** of both tabular data and files.
-- Robust **error handling**.
+The quickest way to get started with Crawlee is by using the Crawlee CLI and selecting one of the prepared templates. First, ensure you have [Pipx](https://pipx.pypa.io/) installed:
 
-### Why to use Crawlee rather than Scrapy?
+```sh
+pipx --help
+```
 
-- Crawlee has out-of-the-box support for **headless browser** crawling (Playwright).
-- Crawlee has a **minimalistic & elegant interface** - Set up your scraper with fewer than 10 lines of code.
-- Complete **type hint** coverage.
-- Based on standard **Asyncio**.
+Then, run the CLI and choose from the available templates:
 
-## Introduction
+```sh
+pipx run crawlee create my-crawler
+```
 
-Crawlee covers your crawling and scraping end-to-end and helps you build reliable scrapers. Fast.
+## Examples
 
-Your crawlers will appear human-like and fly under the radar of modern bot protections even with the default configuration. Crawlee gives you the tools to crawl the web for links, scrape data and persistently store it in machine-readable formats, without having to worry about the technical details. And thanks to rich configuration options, you can tweak almost any aspect of Crawlee to suit your project's needs if the default settings don't cut it.
+Here are some practical examples to help you get started with different types of crawlers in Crawlee. Each example demonstrates how to set up and run a crawler for specific use cases, whether you need to handle simple HTML pages or interact with JavaScript-heavy sites.
 
 ### BeautifulSoupCrawler
 
@@ -167,6 +156,29 @@ if __name__ == '__main__':
 
 Explore our [Examples](https://crawlee.dev/python/docs/examples) page in the Crawlee documentation for a wide range of additional use cases and demonstrations.
 
+## Features
+
+Why Crawlee is the preferred choice for web scraping and crawling?
+
+### Why use Crawlee instead of just a random HTTP library with an HTML parser?
+
+- Unified interface for **HTTP & headless browser** crawling.
+- Automatic **parallel crawling** based on available system resources.
+- Written in Python with **type hints** - enhances DX (IDE autocompletion) and reduces bugs (static type checking).
+- Automatic **retries** on errors or when you’re getting blocked.
+- Integrated **proxy rotation** and session management.
+- Configurable **request routing** - direct URLs to the appropriate handlers.
+- Persistent **queue for URLs** to crawl.
+- Pluggable **storage** of both tabular data and files.
+- Robust **error handling**.
+
+### Why to use Crawlee rather than Scrapy?
+
+- Crawlee has out-of-the-box support for **headless browser** crawling (Playwright).
+- Crawlee has a **minimalistic & elegant interface** - Set up your scraper with fewer than 10 lines of code.
+- Complete **type hint** coverage.
+- Based on standard **Asyncio**.
+
 ## Running on the Apify platform
 
 Crawlee is open-source and runs anywhere, but since it's developed by [Apify](https://apify.com), it's easy to set up on the Apify platform and run in the cloud. Visit the [Apify SDK website](https://docs.apify.com/sdk/python/) to learn more about deploying Crawlee to the Apify platform.
 
@@ -10,55 +10,67 @@ To run Crawlee on your computer, ensure you meet the following requirements:
 
 You can verify these by running the following commands:
 
-```bash
+```sh
 python --version
 ```
 
-```bash
+```sh
 pip --version
 ```
 
 ## Installation
 
 Crawlee is available as the [`crawlee`](https://pypi.org/project/crawlee/) PyPI package.
 
-```bash
+```sh
 pip install crawlee
 ```
 
 Additional, optional dependencies unlocking more features are shipped as package extras.
 
 If you plan to use `BeautifulSoupCrawler`, install `crawlee` with `beautifulsoup` extra:
 
-```bash
+```sh
 pip install 'crawlee[beautifulsoup]'
 ```
 
 If you plan to use `PlaywrightCrawler`, install `crawlee` with the `playwright` extra:
 
-```bash
+```sh
 pip install 'crawlee[playwright]'
 ```
 
 Then, install the Playwright dependencies:
 
-```bash
+```sh
 playwright install
 ```
 
 You can install multiple extras at once by using a comma as a separator:
 
-```bash
+```sh
 pip install 'crawlee[beautifulsoup,playwright]'
 ```
 
 Verify that Crawlee is successfully installed:
 
-```bash
+```sh
 python -c 'import crawlee; print(crawlee.__version__)'
 ```
 
-<!-- TODO: Update this section once templates are ready -->
+## With Crawlee CLI
+
+The quickest way to get started with Crawlee is by using the Crawlee CLI and selecting one of the prepared templates. First, ensure you have [Pipx](https://pipx.pypa.io/) installed:
+
+```sh
+pipx --help
+```
+
+Then, run the CLI and choose from the available templates:
+
+```sh
+pipx run crawlee create my-crawler
+```
 
 ## Next steps
 
 
@@ -30,33 +30,33 @@ Crawlee requires Python 3.9 or later.
 
 Crawlee is available as the [`crawlee`](https://pypi.org/project/crawlee/) PyPI package.
 
-```bash
+```sh
 pip install crawlee
 ```
 
 Additional, optional dependencies unlocking more features are shipped as package extras.
 
 If you plan to use `BeautifulSoupCrawler`, install `crawlee` with `beautifulsoup` extra:
 
-```bash
+```sh
 pip install 'crawlee[beautifulsoup]'
 ```
 
 If you plan to use `PlaywrightCrawler`, install `crawlee` with the `playwright` extra:
 
-```bash
+```sh
 pip install 'crawlee[playwright]'
 ```
 
 Then, install the Playwright dependencies:
 
-```bash
+```sh
 playwright install
 ```
 
 You can install multiple extras at once by using a comma as a separator:
 
-```bash
+```sh
 pip install 'crawlee[beautifulsoup,playwright]'
 ```
 
@@ -182,7 +182,7 @@ The JSON file will contain data similar to the following:
 
 :::tip
 
-If you want to change the storage directory, you can set the `CRAWLEE_LOCAL_STORAGE_DIR` environment variable to your preferred path.
+If you want to change the storage directory, you can set the `CRAWLEE_STORAGE_DIR` environment variable to your preferred path.
 
 :::
 
 
@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "crawlee"
-version = "0.0.8"
+version = "0.1.0"
 description = "Crawlee for Python"
 authors = ["Apify Technologies s.r.o. <support@apify.com>"]
 license = "Apache-2.0"
 
@@ -1,3 +1,3 @@
 from ._utils.globs import Glob
 
-__version__ = '0.0.8'
+__version__ = '0.1.0'
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`from ._utils.globs import Glob`
`2`	`2`
`3`		`-__version__ = '0.0.8'`
	`3`	`+__version__ = '0.1.0'`