Skip to content

Commit 6247735

Browse files
author
hirsch88
committed
face lift for our readme
1 parent b839c0e commit 6247735

File tree

3 files changed

+67
-40
lines changed

3 files changed

+67
-40
lines changed

README.md

Lines changed: 67 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -1,35 +1,38 @@
1-
# Express Typescript Boilerplate
2-
3-
[![Dependency Status](https://david-dm.org/w3tecch/express-typescript-boilerplate/status.svg?style=flat)](https://david-dm.org/w3tecch/express-typescript-boilerplate)
4-
[![Build Status](https://travis-ci.org/w3tecch/express-typescript-boilerplate.svg?branch=master)](https://travis-ci.org/w3tecch/express-typescript-boilerplate)
5-
[![Build status](https://ci.appveyor.com/api/projects/status/f8e7jdm8v58hcwpq/branch/master?svg=true&passingText=Windows%20passing&pendingText=Windows%20pending&failingText=Windows%20failing)](https://ci.appveyor.com/project/dweber019/express-typescript-boilerplate/branch/master)
6-
7-
> A delightful way to building a RESTful API Services with beautiful code written in TypeScript.
8-
> An Node.js Web-Service boilerplate/skeleton/starter-kit featuring
9-
> Inspired by the awesome framework [laravel](https://laravel.com/) in PHP and of the repositories from [pleerock](https://github.com/pleerock).
10-
[TypeScript](https://www.typescriptlang.org/),
11-
[Express](https://expressjs.com/),
12-
[Winston](https://github.com/winstonjs/winston),
13-
[Microframework](https://github.com/pleerock/microframework),
14-
[TypeDI](https://github.com/pleerock/typedi),
15-
[TypeORM](https://github.com/typeorm/typeorm),
16-
[TsLint](http://palantir.github.io/tslint/),
17-
[@types](https://www.npmjs.com/~types),
18-
[Jest](https://facebook.github.io/jest/),
19-
[Swagger](http://swagger.io/),
20-
[validatejs](https://validatejs.org/),
21-
[GraphQL](http://graphql.org/),
22-
[DataLoaders](https://github.com/facebook/dataloader),
23-
by [w3tech](https://github.com/w3tecch)
24-
25-
## Why
1+
<p align="center">
2+
<img src="./w3tec-logo.png" alt="w3tec" width="500" />
3+
</p>
4+
5+
<h1 align="center">❯ Express Typescript Boilerplate</h1>
6+
7+
<p align="center">
8+
<a href="https://david-dm.org/w3tecch/express-typescript-boilerplate">
9+
<img src="https://david-dm.org/w3tecch/express-typescript-boilerplate/status.svg?style=flat" alt="dependency" />
10+
</a>
11+
<a href="https://travis-ci.org/w3tecch/express-typescript-boilerplate">
12+
<img src="https://travis-ci.org/w3tecch/express-typescript-boilerplate.svg?branch=master" alt="travis" />
13+
</a>
14+
<a href="https://ci.appveyor.com/project/dweber019/express-typescript-boilerplate/branch/master">
15+
<img src="https://ci.appveyor.com/api/projects/status/f8e7jdm8v58hcwpq/branch/master?svg=true&passingText=Windows%20passing&pendingText=Windows%20pending&failingText=Windows%20failing" alt="appveyor" />
16+
</a>
17+
</p>
18+
19+
<p align="center">
20+
<b>A delightful way to building a RESTful API Services with beautiful code written in TypeScript.</b></br>
21+
<sub>> Inspired by the awesome framework <a href="https://laravel.com/">laravel</a> in PHP and of the repositories from <a href="https://github.com/pleerock">pleerock</a></sub>
22+
</p>
23+
24+
<br />
25+
26+
![divider](./w3tec-divider.png)
27+
28+
## ❯ Why
2629

2730
Our main goal with this project is a feature complete server application.
2831
We like you to be focused on your business and not spending hours in project configuration.
2932

3033
Try it!! We are happy to hear your feedback or any kind of new features.
3134

32-
## Features
35+
### Features
3336

3437
- **Beautiful Code** thanks to the awesome annotations of the libraries from [pleerock](https://github.com/pleerock).
3538
- **Easy API Testing** with included e2e testing.
@@ -50,7 +53,9 @@ Try it!! We are happy to hear your feedback or any kind of new features.
5053
- **GraphQL** provides as a awesome query language for our api [GraphQL](http://graphql.org/).
5154
- **DataLoaders** helps with performance thanks to caching and batching [DataLoaders](https://github.com/facebook/dataloader).
5255

53-
## Table of Contents
56+
![divider](./w3tec-divider.png)
57+
58+
## ❯ Table of Contents
5459

5560
- [Getting Started](#getting-started)
5661
- [Scripts and Tasks](#scripts-and-tasks)
@@ -64,9 +69,11 @@ Try it!! We are happy to hear your feedback or any kind of new features.
6469
- [Related Projects](#related-projects)
6570
- [License](#license)
6671

67-
## Getting Started
72+
![divider](./w3tec-divider.png)
6873

69-
### Step 1: Set up the Development Environment
74+
## ❯ Getting Started
75+
76+
### Step 1: Set up the Development Environment
7077

7178
You need to set up your development environment before you can do anything.
7279

@@ -112,9 +119,11 @@ npm start serve
112119
> This starts a local server using `nodemon`, which will watch for any file changes and will restart the sever according to these changes.
113120
> The server address will be displayed to you as `http://0.0.0.0:3000`.
114121
115-
## Scripts and Tasks
122+
![divider](./w3tec-divider.png)
123+
124+
## ❯ Scripts and Tasks
116125

117-
All script are defined in the package.json file, but the most important ones are listed here.
126+
All script are defined in the `package-scripts.js` file, but the most important ones are listed here.
118127

119128
### Install
120129

@@ -158,7 +167,9 @@ All script are defined in the package.json file, but the most important ones are
158167
To debug your code run `npm start build` or hit `cmd + b` to build your app.
159168
Then, just set a breakpoint and hit `F5` in your Visual Studio Code.
160169

161-
## API Routes
170+
![divider](./w3tec-divider.png)
171+
172+
## ❯ API Routes
162173

163174
The route prefix is `/api` by default, but you can change this in the .env file.
164175
The swagger and the monitor route can be altered in the `.env` file.
@@ -172,7 +183,9 @@ The swagger and the monitor route can be altered in the `.env` file.
172183
| **/api/users** | Example entity endpoint |
173184
| **/api/pets** | Example entity endpoint |
174185

175-
## Project Structure
186+
![divider](./w3tec-divider.png)
187+
188+
## ❯ Project Structure
176189

177190
| Name | Description |
178191
| --------------------------------- | ----------- |
@@ -212,7 +225,9 @@ The swagger and the monitor route can be altered in the `.env` file.
212225
| ormconfig.json | TypeORM configuration for the database. Used by seeds and the migration. (generated file) |
213226
| mydb.sql | SQLite database for integration tests. Ignored by git and only available after integration tests |
214227

215-
## Logging
228+
![divider](./w3tec-divider.png)
229+
230+
## ❯ Logging
216231

217232
Our logger is [winston](https://github.com/winstonjs/winston). To log http request we use the express middleware [morgan](https://github.com/expressjs/morgan).
218233
We created a simple annotation to inject the logger in your service (see example below).
@@ -230,7 +245,9 @@ export class UserService {
230245
...
231246
```
232247
233-
## Event Dispatching
248+
![divider](./w3tec-divider.png)
249+
250+
## ❯ Event Dispatching
234251
235252
Our we use this awesome repository [event-dispatch](https://github.com/pleerock/event-dispatch) for event dispatching.
236253
We created a simple annotation to inject the EventDispatcher in your service (see example below). All events are listed in the `events.ts` file.
@@ -253,7 +270,9 @@ export class UserService {
253270
}
254271
```
255272
256-
## Seeding
273+
![divider](./w3tec-divider.png)
274+
275+
## ❯ Seeding
257276
258277
Isn't it exhausting to create some sample data for your database, well this time is over!
259278
@@ -367,7 +386,9 @@ npm start db.seed
367386
| `npm start "db.seed --seeds <path>"` | Add a different path to your seeds (Default: `src/database/seeds/`) |
368387
| `npm start "db.seed --config <file>"` | Path to your ormconfig.json file |
369388
370-
## Run in Docker container
389+
![divider](./w3tec-divider.png)
390+
391+
## ❯ Run in Docker container
371392
372393
### Install Docker
373394
@@ -446,7 +467,9 @@ DB_HOST=localhost
446467
DB_PORT=3306
447468
```
448469
449-
## Further Documentations
470+
![divider](./w3tec-divider.png)
471+
472+
## ❯ Further Documentations
450473
451474
| Name & Link | Description |
452475
| --------------------------------- | --------------------------------- |
@@ -468,14 +491,18 @@ DB_PORT=3306
468491
| [GraphQL Documentation](http://graphql.org/graphql-js/) | A query language for your API. |
469492
| [DataLoader Documentation](https://github.com/facebook/dataloader) | DataLoader is a generic utility to be used as part of your application's data fetching layer to provide a consistent API over various backends and reduce requests to those backends via batching and caching. |
470493
471-
## Related Projects
494+
![divider](./w3tec-divider.png)
495+
496+
## ❯ Related Projects
472497
473498
- [Microsoft/TypeScript-Node-Starter](https://github.com/Microsoft/TypeScript-Node-Starter) - A starter template for TypeScript and Node with a detailed README describing how to use the two together.
474499
- [express-graphql-typescript-boilerplate](https://github.com/w3tecch/express-graphql-typescript-boilerplate) - A starter kit for building amazing GraphQL API's with TypeScript and express by @w3tecch
475500
- [aurelia-typescript-boilerplate](https://github.com/w3tecch/aurelia-typescript-boilerplate) - An Aurelia starter kit with TypeScript
476501
- [Auth0 Mock Server](https://github.com/hirsch88/auth0-mock-server) - Useful for e2e testing or faking an oAuth server
477502
478-
## License
503+
![divider](./w3tec-divider.png)
504+
505+
## ❯ License
479506
480507
[MIT](/LICENSE)
481508

w3tec-divider.png

728 Bytes
Loading

w3tec-logo.png

29.6 KB
Loading

0 commit comments

Comments
 (0)