All Projects → delvedor → Fastify Example

delvedor / Fastify Example

Licence: apache-2.0
This project is a small but feature complete application build with Fastify and Svelte, and it aims to show all the core concepts of Fastify, best practices, and recommendations.

Programming Languages

javascript
184084 projects - #8 most used programming language

Projects that are alternatives of or similar to Fastify Example

Terraform With Circleci Example
This is an example of automatic deployments of your infrastructure using terraform and CircleCI 2.0 workflows
Stars: ✭ 142 (-24.06%)
Mutual labels:  example
Examples
Examples of Mock Service Worker usage with various frameworks and libraries.
Stars: ✭ 163 (-12.83%)
Mutual labels:  example
Webassembly Examples
From Simple To Complex. A complete collection of webassembly examples.
Stars: ✭ 177 (-5.35%)
Mutual labels:  example
Go Micro Boilerplate
The boilerplate of the GoLang application with a clear microservices architecture.
Stars: ✭ 147 (-21.39%)
Mutual labels:  example
Unityscreenspaceboolean
Screen Space Boolean Implementation for Unity.
Stars: ✭ 150 (-19.79%)
Mutual labels:  example
Unitymathreference
Math reference for games and more. All visualized in Unity3D.
Stars: ✭ 166 (-11.23%)
Mutual labels:  example
Android Clean Architecture Mvvm Dagger Rx
Implemented by Clean Architecture, Dagger2, MVVM, LiveData, RX, Retrofit2, Room, Anko
Stars: ✭ 138 (-26.2%)
Mutual labels:  example
Ueberauth example
Example Phoenix application using Überauth for authentication
Stars: ✭ 180 (-3.74%)
Mutual labels:  example
Play Scala Isolated Slick Example
Example Play Slick Project
Stars: ✭ 155 (-17.11%)
Mutual labels:  example
React Redux Typescript Realworld App
RealWorld App implementation based on "react-redux-typescript-guide"
Stars: ✭ 178 (-4.81%)
Mutual labels:  example
Leaky Repo
Benchmarking repo for secrets scanning
Stars: ✭ 149 (-20.32%)
Mutual labels:  example
Flutter luckin coffee
flutter luckin coffee application(仿瑞幸咖啡)
Stars: ✭ 150 (-19.79%)
Mutual labels:  example
Slack Starterbot
Python-powered simple starter Slack bot.
Stars: ✭ 169 (-9.63%)
Mutual labels:  example
Kotlin Android Examples
Stars: ✭ 146 (-21.93%)
Mutual labels:  example
Go Grpc Examples
This repo contains examples and implementations of different types of GRPC services and APIs using Golang.
Stars: ✭ 180 (-3.74%)
Mutual labels:  example
Phaser Examples
🎮 Game collections made by Phaser
Stars: ✭ 140 (-25.13%)
Mutual labels:  example
Play Java Starter Example
Play starter project in Java (ideal for new users!)
Stars: ✭ 164 (-12.3%)
Mutual labels:  example
React Workshop
The course material for our React Hooks workshop
Stars: ✭ 184 (-1.6%)
Mutual labels:  example
Melody
🎶 Minimalist websocket framework for Go
Stars: ✭ 2,303 (+1131.55%)
Mutual labels:  example
Owin Webapi Service
✅ OWIN / WebAPI windows service example. Includes attribute based routing sample
Stars: ✭ 175 (-6.42%)
Mutual labels:  example

Fastify App Example

This project is a small but feature complete application build with Fastify and Svelte, and it aims to show all the core concepts of Fastify, best practices, and recommendations.

There is no attached blog post or tutorial, you should go through the application code and read the code comments, which will explain you best practices, protips, suggestions and so forth, I hope you will like it!

What is this application doing?

This application is an URL shortener, it exposes an admin UI and a series of routes under the /_app prefix. Any other request will be interpreted as redirect. If a redirect does not exists, the user will either see a standard 404 page, or a page with a series of suggestions generated by Elasticsearch (both this pages are server side rendered!).

The admin logins via GitHub OAuth, the application is also protected by a rate limiter and during development it exposes a Swagger UI with every endpoint. Read the next section to understand how the project works and how it is recommended to explore it.

Project structure

The project follows a well established pattern within the Fastify community, it has two top level folders, plugins and routes.

project structure

The first one contains all the code that should be shared across your entire aplication, such as authentication and rate limiting, while the second one contains all the business logic, such as the redirect code and the admin APIs.

We recommend to follow this pattern, you can generate a project with the same structure by using fastify-cli.

How should I read through the comments?

You can read the project in any order, but I would recommend the following:

  1. app.js
  2. plugins/authorization.js
  3. plugins/elasticsearch.js
  4. plugins/rate-limit.js
  5. plugins/validUrl.js
  6. plugins/swagger.js
  7. routes/status.js
  8. routes/frontend.js
  9. routes/admin.js
  10. routes/redirect/index.js
  11. routes/redirect/update-count.js
  12. routes/redirect/worker.cjs
  13. routes/redirect/App.svelte
  14. ui/*
  15. test/helper.js
  16. test/plugins/validUrl.test.js
  17. test/routes/status.test.js
  18. test/routes/admin.test.js.test.js
  19. test/routes/redirect.test.js.test.js

FAQ

You are using ESM, how are you compiling the project?

I'm not. From Node.js v12.20 and Node.js v14 ES Modules are supported out of the box. As you can see in the package.json, there is a new field: { "type": "module" }. That field will instruct Node.js that the project is using ESM instead of CJS (common js, which is require/module.exports), and every .js file will be a ESM module, while every .cjs file will be a CJS module.

A follow up question you can ask now is: "why is there a rollup.config.js? Great question! That is used for compiling the Svelte frontend locatated in ui/.

Can I use TypeScript?

Yes! Fastify supports TypeScript out of the box! The project is written in plain JavaScript because I didn't want to add too many things to the project, but probably in the future there will be a branch with a TypeScript implementation.

Why aren't you using a try-catch block in route declarations?

Fastify supports promises/async-await out of the box. Everything is handled for you, if you throw an error inside a route handler (same goes for hooks or plugins) the error will be caught automatically by Fastify and return the most approriate error.

Why Svelte?

No specific reason, any frontend framework will do the job well. I used Svelte because I like it and because it makes it very easy to think about the frontend, without making me think too much about how something should be written or weird APIs, but directly focusing on the business logic while writing almost plain html/css/js.

How to run this project

  1. Create an .env file from the template:

    cp .env.template .env
    
  2. Create a new GitHub OAuth application here, then copy the app id and secret and add them to the env file:

    GITHUB_APP_ID=<app-id>
    GITHUB_APP_SECRET=<app-secret>
    
  3. Add your primary GitHub email to the ALLOWED_USERS variable:

    ALLOWED_USERS=<your-primary-github-mail>
    
  4. Run the keys-generator script and store the result in the COOKIE_SECRET env variable:

    node scripts/keys-generator.js
    
    COOKIE_SECRET=<generated-key>
    

Now you can either run the project locally or deploy it.

Locally

  1. Use Node.js v14.

    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.37.2/install.sh | bash
    nvm install 14
    node -v # should be v14.minor.patch
    
  2. Install the project dependencies:

    npm install
    
  3. In a separate terminal window, run Elasticsearch:

    npm run elasticsearch
    
  4. Once Elasticsearch is up and running, run the prepare-elasticsearch script and copy the result in the ELASTIC_URL and ELASTIC_API_KEY env variables:

    node scripts/prepare-elasticsearch.js
    
    ELASTIC_ADDRESS=<result.address>
    ELASTIC_API_KEY=<result.apiKey>
    
  5. You are all set! Run the project with thw following command:

    npm run dev
    

Deploy

This section contains instructions for deploying this application.

Would you like to see more recipes? Open an issue. Do you already have a deploy recipe and want to share it? That's awesome, send a pull request!

Cloud Run

Open deploy-recipes/cloud-run, you will find everything you need there.

Elastic Cloud

You can create an Elasticsearch cluster with Elastic Cloud, with a free 14-day trial of the Elasticsearch Service.

Contribute

Feel free to send pull request with new features, bugfix or documentation improvements!

Questions

Open an issue or take a look at our fastify/help repository. We also have a Discord community you can join.

If you have any question related to Elasticsearch or the Elasticsearch client, you can open a new discussion on discuss.elastic.co or in the client issue tracker.

License

This software is licensed under the Apache 2 license.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].