examples/README.md

# Actix Examples

> Curated examples using the Actix ecosystem.

[![build status](https://github.com/actix/examples/workflows/CI%20%28Linux%29/badge.svg?branch=master&event=push)](https://github.com/actix/examples/actions)
[![Chat on Discord](https://img.shields.io/discord/771444961383153695?label=chat&logo=discord)](https://discord.gg/NWpN5mmg3x)

## Community Showcase

- [Nitro Repo](https://github.com/wherkamp/nitro_repo): An open source artifact manager. Rust back-end and Vue front-end.
- [Imitari](https://github.com/imitari/imitari): A lightweight ShareX-compatible image uploader server
- [roapi](https://github.com/roapi/roapi): Create full-fledged APIs for static datasets without writing a single line of code.
- [mCaptcha](https://github.com/mCaptcha/mCaptcha/): Proof of work based, privacy focused, libre CAPTCHA system. Crates used: `actix-web`, `sqlx`, `redis`, and `lettre`.
- [Zero2prod](https://github.com/LukeMathWalker/zero-to-production/): Source code of zero to production series [zero2prod.com](https://www.zero2prod.com). Paid book but some of the chapters is available online for free. The book compares and explains the chosen technologies, like actix-web and sqlx.
- [Triox](https://github.com/Trioxidation/Triox): A free file hosting server that focuses on speed, reliability and security.
- [binserve](https://github.com/mufeedvh/binserve): A fast, secure, and easy to set up static web server written on top of Actix Web with routing, templating, and various other features.
- [Roseline](https://github.com/DoumanAsh/roseline.rs): A personal web site and discord & IRC bot to access simple SQLite database. Demonstrates usage of various Actix and Actix Web concepts.
- [lemmy](https://github.com/dessalines/lemmy): A federated alternative to reddit in Rust.
- [MeiliSearch](https://github.com/meilisearch/MeiliSearch): Fast, Relevant and Typo-Tolerant Search Engine. Open source alternative to Algolia.
- [Dalted](https://github.com/carrascomj/dalted): Simple webapp that showcases the integration of [image-rs](https://github.com/image-rs/image) with Actix Web for color blindness simulations.
- [Four in a Row - Server](https://github.com/ffactory-ofcl/fourinarow-server): An online version of the popular game four in a row, written in Rust on the server side and Flutter + Dart on the client.

## Community Articles, Example Apps, Starters & Boilerplate Projects

- [Jelly Starter](https://github.com/secretkeysio/jelly-actix-web-starter): A starter template for actix-web projects that feels very Django-esque. Avoid the boring stuff and move faster.
- [Actix and SQLx User CRUD for MySQL](https://github.com/jamesjmeyer210/actix_sqlx_mysql_user_crud): A User CRUD showcasing MySQL database interaction with full integration test coverage, designed to fit comfortably in a system of micro-services.
- [webapp.rs](https://github.com/saschagrunert/webapp.rs): A web application completely written in Rust.
- [RealWorld Example App](https://github.com/fairingrey/actix-realworld-example-app): Implementation of the RealWorld backend API spec in Actix.
- [Canduma](https://github.com/clifinger/canduma): Rust authentication server boilerplate
- [Rust, Docker & GraphQL](https://github.com/jayy-lmao/rust-graphql-docker): An example of using Dataloaders, context, and a minimal docker container.
- [Complete Actix 2.x REST Server](https://github.com/ddimaria/rust-actix-example): Actix 2.x HTTP Server featuring multi-database support, auth/JWTs, caching, static files, app state, tests, coverage, and docker.
- [Actix Server Authentication with JWT and MongoDB](https://github.com/emreyalvac/actix-web-jwt/): An implementation of JWT in Actix.
- [Production-Grade Logging in Rust Applications](https://medium.com/better-programming/production-grade-logging-in-rust-applications-2c7fffd108a6): An article showcasing the use of [tracing](https://github.com/tokio-rs/tracing) in an Actix application
- [Fullstack-Rust](https://github.com/vascokk/fullstack-rust): A Full Stack Rust application (Connect5 game) with Actix-web, Yew, Bulma CSS and Diesel.

## Paid Resources
- [book] [Zero2prod by Luca Palmieri](https://algoluca.gumroad.com/l/zero2prod): Takes you on a journey to discover the world of backend development in Rust.

## Contribute

Pull requests welcome for small, focussed example projects demonstrating patterns or techniques.

Submissions also accepted to have your app or repo considered for the showcase lists.
split showcase into live projects and boilerplates 2020-10-14 18:53:51 +02:00			`# Actix Examples`
Update README.md 2018-04-13 03:26:33 +02:00
tweak readme wording 2020-10-14 18:55:02 +02:00			`> Curated examples using the Actix ecosystem.`
split showcase into live projects and boilerplates 2020-10-14 18:53:51 +02:00
			`[![build status](https://github.com/actix/examples/workflows/CI%20%28Linux%29/badge.svg?branch=master&event=push)](https://github.com/actix/examples/actions)`
Update README.md 2021-06-08 20:55:45 +02:00			`[![Chat on Discord](https://img.shields.io/discord/771444961383153695?label=chat&logo=discord)](https://discord.gg/NWpN5mmg3x)`
Update README.md 2018-04-13 03:26:33 +02:00
add webapp.rs to community examples 2020-10-14 18:41:36 +02:00			`## Community Showcase`
split showcase into live projects and boilerplates 2020-10-14 18:53:51 +02:00
Update README.md 2021-10-28 17:26:31 +02:00			`- [Nitro Repo](https://github.com/wherkamp/nitro_repo): An open source artifact manager. Rust back-end and Vue front-end.`
			`- [Imitari](https://github.com/imitari/imitari): A lightweight ShareX-compatible image uploader server`
Update README.md 2021-09-21 14:18:10 +02:00			`- [roapi](https://github.com/roapi/roapi): Create full-fledged APIs for static datasets without writing a single line of code.`
add mCaptcha (#439) 2021-07-20 17:01:13 +02:00			- [mCaptcha](https://github.com/mCaptcha/mCaptcha/): Proof of work based, privacy focused, libre CAPTCHA system. Crates used: `actix-web`, `sqlx`, `redis`, and `lettre`.
Update README.md 2021-10-28 17:26:31 +02:00			`- [Zero2prod](https://github.com/LukeMathWalker/zero-to-production/): Source code of zero to production series [zero2prod.com](https://www.zero2prod.com). Paid book but some of the chapters is available online for free. The book compares and explains the chosen technologies, like actix-web and sqlx.`
			`- [Triox](https://github.com/Trioxidation/Triox): A free file hosting server that focuses on speed, reliability and security.`
			`- [binserve](https://github.com/mufeedvh/binserve): A fast, secure, and easy to set up static web server written on top of Actix Web with routing, templating, and various other features.`
			`- [Roseline](https://github.com/DoumanAsh/roseline.rs): A personal web site and discord & IRC bot to access simple SQLite database. Demonstrates usage of various Actix and Actix Web concepts.`
			`- [lemmy](https://github.com/dessalines/lemmy): A federated alternative to reddit in Rust.`
			`- [MeiliSearch](https://github.com/meilisearch/MeiliSearch): Fast, Relevant and Typo-Tolerant Search Engine. Open source alternative to Algolia.`
			`- [Dalted](https://github.com/carrascomj/dalted): Simple webapp that showcases the integration of [image-rs](https://github.com/image-rs/image) with Actix Web for color blindness simulations.`
Update README.md 2021-11-02 14:04:17 +01:00			`- [Four in a Row - Server](https://github.com/ffactory-ofcl/fourinarow-server): An online version of the popular game four in a row, written in Rust on the server side and Flutter + Dart on the client.`
split showcase into live projects and boilerplates 2020-10-14 18:53:51 +02:00
Adds an article on the use of tracing in actix Related [Reddit comment](https://www.reddit.com/r/rust/comments/jv6a5j/productiongrade_logging_in_rust_applications/gcib8ml?utm_source=share&utm_medium=web2x&context=3). 2020-11-19 15:58:10 +01:00			`## Community Articles, Example Apps, Starters & Boilerplate Projects`
split showcase into live projects and boilerplates 2020-10-14 18:53:51 +02:00
Update README.md 2021-10-28 17:33:44 +02:00			`- [Jelly Starter](https://github.com/secretkeysio/jelly-actix-web-starter): A starter template for actix-web projects that feels very Django-esque. Avoid the boring stuff and move faster.`
			`- [Actix and SQLx User CRUD for MySQL](https://github.com/jamesjmeyer210/actix_sqlx_mysql_user_crud): A User CRUD showcasing MySQL database interaction with full integration test coverage, designed to fit comfortably in a system of micro-services.`
			`- [webapp.rs](https://github.com/saschagrunert/webapp.rs): A web application completely written in Rust.`
			`- [RealWorld Example App](https://github.com/fairingrey/actix-realworld-example-app): Implementation of the RealWorld backend API spec in Actix.`
			`- [Canduma](https://github.com/clifinger/canduma): Rust authentication server boilerplate`
split showcase into live projects and boilerplates 2020-10-14 18:53:51 +02:00			`- [Rust, Docker & GraphQL](https://github.com/jayy-lmao/rust-graphql-docker): An example of using Dataloaders, context, and a minimal docker container.`
			`- [Complete Actix 2.x REST Server](https://github.com/ddimaria/rust-actix-example): Actix 2.x HTTP Server featuring multi-database support, auth/JWTs, caching, static files, app state, tests, coverage, and docker.`
Update README.md 2021-10-28 17:33:44 +02:00			`- [Actix Server Authentication with JWT and MongoDB](https://github.com/emreyalvac/actix-web-jwt/): An implementation of JWT in Actix.`
			`- [Production-Grade Logging in Rust Applications](https://medium.com/better-programming/production-grade-logging-in-rust-applications-2c7fffd108a6): An article showcasing the use of [tracing](https://github.com/tokio-rs/tracing) in an Actix application`
			`- [Fullstack-Rust](https://github.com/vascokk/fullstack-rust): A Full Stack Rust application (Connect5 game) with Actix-web, Yew, Bulma CSS and Diesel.`

			`## Paid Resources`
			`- [book] [Zero2prod by Luca Palmieri](https://algoluca.gumroad.com/l/zero2prod): Takes you on a journey to discover the world of backend development in Rust.`
Update Multipart example (#196) * add async/await multipart example * fix * replace multipart * make PR feedback changes * remove port & heroku & update readme * update cargo.toml to be correct * update to alpha 3 2019-12-07 15:40:31 +01:00
Update README.md 2018-04-13 03:26:33 +02:00			`## Contribute`
add badges 2018-04-13 04:09:01 +02:00
split showcase into live projects and boilerplates 2020-10-14 18:53:51 +02:00			`Pull requests welcome for small, focussed example projects demonstrating patterns or techniques.`

			`Submissions also accepted to have your app or repo considered for the showcase lists.`