diff --git a/README.md b/README.md
index 16b750c17..58cbdf0ec 120000
--- a/README.md
+++ b/README.md
@@ -1 +1,122 @@
-actix-web/README.md
\ No newline at end of file
+
+
Actix Web
+
+ Actix Web is a powerful, pragmatic, and extremely fast web framework for Rust
+
+
+
+
+
+[](https://crates.io/crates/actix-web)
+[](https://docs.rs/actix-web/4.13.0)
+
+
+[](https://deps.rs/crate/actix-web/4.13.0)
+
+[](https://github.com/actix/actix-web/actions/workflows/ci.yml)
+[](https://codecov.io/gh/actix/actix-web)
+
+[](https://discord.gg/NWpN5mmg3x)
+
+
+
+
+
+
+## Features
+
+- Supports _HTTP/1.x_ and _HTTP/2_
+- Streaming and pipelining
+- Powerful [request routing](https://actix.rs/docs/url-dispatch/) with optional macros
+- Full [Tokio](https://tokio.rs) compatibility
+- Keep-alive and slow requests handling
+- Client/server [WebSockets](https://actix.rs/docs/websockets/) support
+- Transparent content compression/decompression (br, gzip, deflate, zstd)
+- Multipart streams
+- Static assets
+- SSL support using OpenSSL or Rustls
+- Middlewares ([Logger, Session, CORS, etc](https://actix.rs/docs/middleware/))
+- Integrates with the [`awc` HTTP client](https://docs.rs/awc/)
+- Runs on stable Rust 1.88+
+
+### Experimental features
+
+To enable faster release iterations, we mark some features as experimental.
+These features are prefixed with `experimental` and a breaking change may happen at any release.
+Please use them in a production environment at your own risk.
+
+- `experimental-introspection`: exposes route and method reporting helpers for local diagnostics
+ and tooling. See [`examples/introspection.rs`](examples/introspection.rs) and
+ [`examples/introspection_multi_servers.rs`](examples/introspection_multi_servers.rs).
+
+## Documentation
+
+- [Website & User Guide](https://actix.rs)
+- [Examples Repository](https://github.com/actix/examples)
+- [API Documentation](https://docs.rs/actix-web)
+- [API Documentation (mainranch)](https://actix.rs/actix-web/actix_web)
+
+## Example
+
+Dependencies:
+
+```toml
+[dependencies]
+actix-web = "4"
+```
+
+Code:
+
+```rust
+use actix_web::{get, web, App, HttpServer, Responder};
+
+#[get("/hello/{name}")]
+async fn greet(name: web::Path