https://github.com/dwyl/book

📗 Our Book on Full-Stack Web Application Development covering User Experience (UX) Design, Mobile/Offline/Security First, Progressive Enhancement, Continuous Integration/Deployment, Testing (UX/TDD/BDD), Performance-Driven-Development and much more!
https://github.com/dwyl/book

book

Last synced: about 1 month ago
JSON representation

📗 Our Book on Full-Stack Web Application Development covering User Experience (UX) Design, Mobile/Offline/Security First, Progressive Enhancement, Continuous Integration/Deployment, Testing (UX/TDD/BDD), Performance-Driven-Development and much more!

• Host: GitHub
• URL: https://github.com/dwyl/book
• Owner: dwyl
• Created: 2013-10-20T11:54:06.000Z (almost 11 years ago)
• Default Branch: main
• Last Pushed: 2024-01-16T03:58:50.000Z (8 months ago)
• Last Synced: 2024-04-14T14:57:29.057Z (5 months ago)
• Topics: book
• Language: Rust
• Homepage: https://dwyl.github.io/book/
• Size: 16.3 MB
• Stars: 817
• Watchers: 52
• Forks: 132
• Open Issues: 65
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md

Awesome Lists containing this project

README

        


# The _Practical_ Book 
on 
_Crafting_ Full-Stack Web & Mobile Apps

[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/dwyl/book/ci.yml?label=build&style=flat-square&branch=main)](https://github.com/dwyl/book/actions)

[![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat-square)](https://github.com/dwyl/book/issues)

[![HitCount](https://hits.dwyl.com/dwyl/book.svg)](https://github.com/dwyl/book)



A ***step-by-step guide*** to "***Full Stack***" 

Web & Mobile Application Development

for people building ***beautiful***, ***robust*** & ***maintainable***

apps individually or in teams!

# Why?

Think/say what you like about Steve,

he was _right_ about (_at least_) one thing:

![steve jobs learn how to code!](https://cloud.githubusercontent.com/assets/194400/21953417/2bb48e3c-da2e-11e6-8ae9-2a46fa6e2a7d.png)

Considering that there are

[_millions_ of "Apps"](https://www.statista.com/statistics/276623/number-of-apps-available-in-leading-app-stores/)

_already_, why should I (_or anyone for that matter_) bother

learning how to make _more_ of them?

This is a _great_ question and one we ask _ourselves_

[@dwyl](https://twitter.com/dwyl) _often_!  

The _answer_ is _another_ question: do you think _all_ the world's

problems/challenges have been _resolved_...?

To which the _answer_ is: ***not even close!***

# How? 

## Read it Online

Read it 

[dwyl.github.io/book](https://dwyl.github.io/book/)

## Read it _Offline_ 

While viewing the online version,

click the "Print" icon 

in the top-right of this screen: ↗️



Then you can save the page 

either as `HTML` or `PDF`

and read it ***offline***

without any distractions.

## _Run_ it on your `localhost`

Run the following commands 

in the `Terminal` on your computer:

```sh

git clone [email protected]:dwyl/book.git & cd book

cargo install mdbook

mdbook serve --open

```

That will open your Web Browser with the book.

> **Note**: that `cargo` command 

_assumes_ you have `Rust` installed on your machine. 


If you don't already, see: 

[dwyl/learn-rust#installing](https://github.com/dwyl/learn-rust#installing)

# Contributing

To help us improve the book,

the easiest way is to 

`edit` it directly on `GitHub`:

[dwyl/book/src](https://github.com/dwyl/book/tree/main/src)

While reading the book online,

simply click/tap the "Edit" button on any page:



That will take you straight to the page

where you can make your changes and create a Pull Request.

## Editing on `localhost`

Just open the `/src` directory and edit the file you want to improve.

> **Note**: If you get stuck,

we recommend reading:

[rust-lang/mdBook](https://rust-lang.github.io/mdBook/). 


You don't need to know `Rust` to understand any of it.