Portfolio Backend

Setup

1. Clone this repository by running git clone [email protected]/nebuloid-blog/backend.git.
2. In your terminal, cd into the project root.
3. Create a .env file and populate it with the requisite data!
4. Run yarn to install dependencies.
5. Run git submodule init to register submodules.
6. Run git submodule update to clone submodules.
7. Open Docker Desktop and run docker-compose up -d.
8. Finally, you can run yarn start or yarn dev.
9. Now, you can use apps like MongoDB Compass and Altair GraphQL Client!

Project Details

Notable Technologies

• GraphQL
• GraphQL Code Generator
• Express
• Mongoose
• Node
• TypeScript

Opinions

I started this project out using Express + GraphQL. GraphQL is my preferred choice for APIs because of how fast it is!

This project does not use Apollo GraphQL, because it wasn't reasonable or me to build the backend with that large of a scope. If needed, I can grab utilities from Apollo à la carte. See also, GraphQL the Simple Way.

When creating an API, the frontend is only as powerful as the backend! The backend opts to use GraphQL Codegen for type declarations. See also, GraphQL.js vs. TypeGraphQL vs. GraphQL Nexus

Linters

For this project, I've opted to generate my own styleguide to follow. I'd like to delve into the deep end of formatters and understand what they are capable of. After all, I do have my own opinions about code style, as does everyone else of course. To make this work, I've extended my own ESLint config, Tabbify.

Tutorials

• Creating an API with GraphQL
• GQL CodeGen for MongoDB
• Type Safety for GQL Resolvers