Folder Structure for API's - Beginner, Intermediate, and Advanced

Подписаться 206 тыс.

Просмотров 131 тыс.

50% 1

Best Tech Resume Template: papermoontech.com/pmcsrtk/pedro
Use code: PEDRO for 20% off ^
In this video we will go over some examples of folder structures you might want to use when building an API using NodeJS and Express. This can also be applied when building API's using any other type of language / framework. There is no correct folder structure, this are just my opinions.
Comment down below your favourite rite structure!
-
🚀 Learn ReactJS By Building 6 Projects: codedamn.com/learn/reactjs-pr...
Please leave a comment on what topic you guys want me to cover next!
-
📞 Tutoring Session: www.fiverr.com/share/pw8RPY
💻 PedroTech Discord: / discord
-
Social
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
Website: machadopedro.com
Twitter: / pedrotech_
Linkedin: / machadop1407
Instagram: / _pedro.machado_
Github: github.com/machadop1407
Email: machadop1407@gmail.com
Timestamps
00:00 | Introduction
01:04 | Beginners
08:12 | Intermediate
12:37 | Advanced
Tags:
- Express API
- Folder Structure
- ReactJS Tutorial
- ReactJS and MySQL
- NodeJS Tutorial
- API Tutorial

Наука

Опубликовано:

11 июл 2024

Ссылка:

Скачать:

Готовим ссылку...

Добавить в:

Мой плейлист

Посмотреть позже

Комментарии : 162

@gerooq 3 года назад

"if you're a beginner, dont worry about folder structure too much, you're gonna write garbage code anyways" LMAOOOOO

@PedroTechnologies 3 года назад

Hahaha I still remember my first nodejs / express project. I wrote a whole API for a social media platform in a single file :)

@gerooq 3 года назад

@@PedroTechnologies damn hahaha, great video though, i think i'll do a mix of all 3 types that you showed for my project

@CodingByAmp 3 года назад

sam

@LordVodka313 2 года назад

This right here is an absolute truth. My first expressJs app was a single line with an accumulation of all that I learnt as I went. Now I can't even look at it without my eyes bleeding. One thing that is underrated/not emphasized enough is that the first version of any app is the TRUE process of requirement gathering/skill proficiency: that's where you really close the gap between the things _you know that know_ and the things _you don't know that you don't know_

@henriqueb5637 Год назад

Not necessarily. There are beginners who write cleaner code than most experienced developers. It depends on the teacher and/or learning material source

@yankarlotexeira 2 года назад

For advance mode: I suggest adding a repositories folder, where it handles the database operations, and letting the services just handling the business logic. It makes it easier to migrate to another database.

@florianfanderl6674 2 года назад

How often did you migrate to another database? I hear this argument so often, but I havent changed the database once, nor has anybody I know.

@yankarlotexeira 2 года назад

@@florianfanderl6674 , I got your point, but I saw this twice, and the last one has been very smooth due to this practice. Moreover, It doesn´t hurt to implement it just in case. Anyway, keep the risk matrix chart in mind based on the requirements.

@florianfanderl6674 2 года назад

@@yankarlotexeira well at least you had that case. First time I hear somebody actually did that. I tend to get VERY cautious, if people put things into code they don't need more, but might need later. Also later never arrives. Add 15 of such things and you for a mess. E.g. there's also the habit of putting 100 random things into application config that actually don't change, just because they seem to belong into the application config. Even worse when they're actually not really supported to change. There are so many ways to make software generic and it really helps when this piece of software actually needs to be generic for a real need. But I heavily advise against it, just for the "what if". But yeah, data access in general isn't too hard to abstract. So it doesn't introduce a lot of complexity.

@pawnstar8771 2 года назад

hey, In my code I am using mySQL queries inside APIs. So according to you I should have repository folder containing a file with query?

@yankarlotexeira 2 года назад

@@pawnstar8771 yes. It makes easier to isolate problems, easier to do unit tests, and in my opinion it would make the code cleaner and more maintainable.

@jacobtb1 3 месяца назад

It's amazing how difficult finding information on this topic has been. Thanks.

@chanelyma 2 года назад

Hi Pedro, thanks for sharing it. I was going really crazy about folder structure and in the end you make very clear that there's more about it than meets the eye.

@nagwarg 2 года назад

Obrigado Pedro! Your videos have been helping me a lot in getting back into web dev after a few months break. You're the man! Can you point out any public repos for advanced projects that use a similar stack and structure? I think that would really help connect all the dots if we could see something simmilar implemented in a mature project. Cheers! Keep it up on being awsome!

@idevbrandon 2 года назад

Thank you Pedro this is what i needed for my project :)

@victoriaabonin 3 года назад

really nice video, knowing a common production folder structure helps understand node itself

@RrR2010 Год назад

Ganhou mais um inscrito. Estou em busca de vídeos mais avançados assim já faz algum tempo. A maioria dos vídeos são bem "Getting Started" e não mostram as melhores práticas que podem facilitar na escalabilidade dos projetos. Obrigado!!!

@rodcurvelo4075 3 года назад

Muito bacana Pedro! Vc foi direto ao ponto. Espero que você faça um video de um projeto com essa estrutura avançada de pastas, junto com REACT, usando talvez o PERN stack e usando o TDD. Já me inscrevi. Quero passar pra senior e ter modelos como inspiração para futuros projetos.

@BarakAlmog 2 года назад

Beautiful! Exactly what I was looking for. Thanks so much.

@rayvincentdelacruz8251 3 года назад

Great bro! This is an excellent content we need. Keep it up!

@PedroTechnologies 3 года назад

Really appreciate it! I am happy you liked it!

@Landon_Hughes 3 года назад

Great tutorial man! I'm just getting into React so this was helpful :)

@PedroTechnologies 3 года назад

Glad it helped!

@MarioLariosOfficial Год назад

Thanks for this video it helped so much man, especially right now in my bootcamp.

@jojojawjaw 3 года назад

What a great tutorial! concise, yet really informative!

@PedroTechnologies 3 года назад

Glad you liked it

@saurabhjdas786 2 года назад

I like how the beginner folder structure had PascalCase for the folder names, kinda like class names lol. Great video, very informative!

@vieiratn 3 года назад

Amazing content, dude! I'm trying to improve my code and you're helping me a lot. Really appreciated! :)

@PedroTechnologies 3 года назад

Thats awesome! I am glad you are learning!

@vieiratn 3 года назад

@@PedroTechnologies TMJ!

@mitejmadan8672 2 года назад

Thanks for creating this video. Really helped a lot

@Omer-jb2io 2 года назад

Finally, I couldn't find anyone that actually explained it.

@vishwajitbhagat9515 2 года назад

That's all that I needed. Thanks, buddy

@ThColinPereira 3 года назад

this is so well explained, thanks pedro

@failist9570 3 года назад

Thanks Pedro for this. Please make more content on production grade setup and practices.

@PedroTechnologies 3 года назад

I really enjoyed the support on this video so I plan on making more like this!

@shubhamjha1473 2 года назад

Short and precise. Best combo 👍

@PedroTechnologies 2 года назад

Glad you think so!

@fares.abuali 2 года назад

Thanks Pedro! Precious info

@guilhermejoviniano4352 Год назад

thanks for the video dude!, really good content!

@theDanielJLewis 2 года назад

Thank you for this great overview!

@Pawii 3 года назад

Thank you for sharing your knowledge! really great stuff!!!

@PedroTechnologies 3 года назад

Glad you liked it!

@greykor140 3 года назад

Didn't know there was a video on this LOL. Ended up watching one of your tutorial series video to see how things were structured!

@PedroTechnologies 3 года назад

Hahaha hope you liked it :)

@nazrulchowdhury1047 2 года назад

A separate data layer could also be added in the advanced section. This layer will interact with db and could be imported in the service layer to be used as a database adaptor. Then in case of a db swap, just the adaptor has to be re-implemented without even touching the rest of the application.

@PedroTechnologies 2 года назад

Good point!

@zafariqbal92 6 месяцев назад

This is helpful, thank you!

@aayushtaneja70 3 года назад

We can keep the Models and Helpers out of the api/v1 folder because the database models do not depend on the version of API. Also, the utils/helpers also don't change I guess.

@rammehar5531 2 года назад

Very Clean Explanation wonderful

@wassefbenahmed1801 2 года назад

thank you, this was very helpful!

@MiladAKareem 2 года назад

This video was very beneficial for me thanks a lot for such a good video, this kind of video is a need for the RU-vid community. wish you the best.

@herickvinicius 3 года назад

QUE MASSA! Eu tinha essa curiosidade desde que comecei a desenvolver APIs e finalmente achei um conteúdo massa sobre isso! Parabéns mano! (Mais legal ainda é ter assistido o video inteiro achando que era de algum americano e no final descobrir que é um brazuca hahahah)

@PedroTechnologies 3 года назад

Kkkkkkkk muita gente nao percebe até ler meu nome. Fico feliz que gostou do video :)

@MrMonishSoni Год назад

In advanced level : I like separation of api versioning api/v1, api/v2 but its debatable for versioning vs subdomain. Rather than that i prefer app folder containing MVC + index.ts (entry point) Initially and if the project scales then separation based on component/functionality i.e lets say we've 3 comp. user, product, order. so each comp. have their own MVC, rest is same. What do you think ?

@karlasosa5304 3 года назад

Great video Pedro thank you!

@PedroTechnologies 3 года назад

Glad you liked it!

@pankajkhushalani 2 года назад

Amazing content! Thank you for this video

@PedroTechnologies 2 года назад

Glad you liked it!

@mrinaldhawan3959 2 года назад

Thank you pedro for such an amazing video. I had looking for something like this all around. I am now planning to use your intermediate folder structure, as I am fairly new to Nodejs. I have one doubt though, where should I place 3rd Party API Calls? 3rd Party API calls I am integrating will include CRUD operations of their own. Infact, I need to perform CRUD in my database based on success/failure of 3rd party API CRUD operations. Any suggestions will be of great help.

@rokeebashobiye1242 2 года назад

This is a great one dude.. Can you make a tutorial using the advanced folder structure for a project?

@hijuliansosa 3 года назад

It's great, thanks!

@jorgelopezcuns Год назад

Muy buen video Pedro

@ahmedelgaidi 2 года назад

Really good video Thanks a lot

@sreekumarmenon 2 года назад

Informative ! Folder structure + some code would have been more useeful ~

@PanlasangMotour 3 года назад

Noice !! :) great job

@PedroTechnologies 3 года назад

Thanks! 😄

@salehmohammednasseralobidi5880 3 года назад

Excellent job amazing Can make simple project for this structure to be amazing

@mansilaad2062 3 года назад

Really appreciating content 👍👍 Plz make video on mvc model which u talked about.

@PedroTechnologies 3 года назад

I plan on it! Thank you!

@robsonreis3450 3 года назад

Amazing tips!!!!

@PedroTechnologies 3 года назад

Thank you! Glad you liked it!

@suhaimitech9973 3 года назад

Hi, do you have any project that uses medium or advanced structure? I would like to see what code goes in the folder

@metalshocker93 2 года назад

What do we have to put in the index.ts file that you create in the service folder of advance level? Do we need to add something in particular in order to access the classes the way you explained it, by only calling the service folder when we do the import?

@kunjchoksi 3 года назад

Great informative video. I was a bit confused to start & you have made it clear to me. Thanks

@PedroTechnologies 3 года назад

Glad I was able to help!

@alexanderzharkov6953 2 года назад

I will definitely subscribe to this channel

@edu.paixao Год назад

Vlw, Pedro

@pranjalwalia3810 3 года назад

Great stuff..Kudos on the intro... testing express n mongo APIs TS with jest... something to cover in the next video?

@PedroTechnologies 3 года назад

Thank you! I am planning on doing a video on API testing!

@dawid_dahl 3 года назад

Seconded! Jest/supertest. Also a video on mocking best practices would be awesome.

@nomchomppom 3 года назад

hey, thanks for the video! would clerify what goes in the "service" folder? would this be someting like getting extra resources from another restAPI or even connecting with another webservice like optimizing photos etc?

@PedroTechnologies 3 года назад

Yes!

@j9meslloyd810 Год назад

Great videos. Pls Pedro, can i know the differences between services ans helpers in your project structure

@luiza4142 3 года назад

Adorei o canal, agora preciso aprender inglês "de vdd" hahaha

@PedroTechnologies 3 года назад

kkkkkkk obrigado mano!

@haddadabdallah 2 года назад

Good job

@codesmiles_ Год назад

I the advanced section of this video, what type of test is the test folder that sit alongside src be running

@faiqkhan7545 2 года назад

I wanna know is that, advance structure is control by only one person ? Or multiple members work on it to maintain it ?

@felipeserrano9173 3 года назад

Nice!

@ratul1125 2 года назад

I also like having a "utils" folder where I add all the utility functions

@snake1625b 2 года назад

Do you suggest mocking a local database for testing database querying

@inlinex Год назад

Question... How Can you call the modules related to controller or you use a Shared Module.? I like Advanced Folder Structure

@matthewmarsala1788 2 года назад

For the index.ts files. I guess the concept is a bit confusing. Shouldn't it say export since you're exporting the files in those folders so they can accessed elsewhere?

@amanbadhan7546 Месяц назад

Hi , hee is the best explanation of folder structure. I have a question. Can you tell me how to manage the folder structure in the case of when are writting code for admin , user and vendor in the same project. Please explain this as well ... Thank you

@nickjunes Год назад

I'm a programmer of 20 years and I've been strongly questioning MVC lately especially on the backend. Mainly there is a lot more logic that needs to be shared. It's obvious services needed to be invented because it couldn't all be contained in the controller level, but it's still not good enough. The model layer is also outdated. It's just a thin layer to the DB so it shouldn't be given so much weight. Applications are no longer desktop apps that save data on a hardrive. We have lots of logic that needs to be shared between lots of services and controllers. We probably need something that is more along the lines of (Routes) | (Controllers) | (Logic -> Components -> Small Functions, External API Calls and Models). Top level in () and -> is nested. Logic is where the business logic is and it may call other peer elements at times. Components would only ever call lower in the tree.

@katalystcod2 10 месяцев назад

so what do you propose? give a concrete example with file structure and logic?

@nickjunes 10 месяцев назад

@@katalystcod2Lately I have, Routes, Controllers, Services, and Utilities. I don't personally use a database folder because I always an ORM and database access doesn't require any complex connection logic. That's on the backend. If we're talking about the front end then a lot of people are using projects like Next.js where the routes are actually defined by the file location, then you might have a global Context folder where your "model" is but you don't call it that. Then you may also have "hooks" and "components" folders for re-usable logic. My main point is that on both the backend and the front end it makes more sense to organize things by what we actually need and what we're actually doing and that's how most modern projects are organized. Having an actual "model", "view", and "controller" folder isn't always necessary. It's more a general concept. Although I do use a controller folder on the backend. On the front end a "controller" folder isn't really necessary.

@maxmaksum4673 3 года назад

excellent

@PedroTechnologies 3 года назад

Thanks!

@adventurer2395 2 года назад

Thank you! Why would you do validation in the controller instead of the service? isn’t that business logic?

@anoopjoy501 2 года назад

What are the other popular design patterns? Apart from MVC

@L4zEGaming 3 года назад

Are you using yarn 2? Could you make a video on package managers, great video btw

@PedroTechnologies 3 года назад

Thank you! Yes I use yarn 2! I can make one but I think both npm and yarn are equally good

@mahardhikaputra 11 месяцев назад

src (model controller middleware helper environment router) Always use that schema folder in api what I made

@mani_naik 3 года назад

new Intro

@PedroTechnologies 3 года назад

Glad you liked it! Im very happy with the result!

@mansilaad2062 3 года назад

What would be the folder structure for react large project where we call Apis as well as axios request etc..

@PedroTechnologies 3 года назад

I want to make a video on react project structures! But I would create a personalized hook for making api calls!

@wasit-shafi 26 дней назад

what if we have also have contents in v2 directory, then how will your directory structure change as we also have to make sure we are not repeating the code, eg you have put Helpers inside v1 . any comments on that...?

@me_debankan4178 9 месяцев назад

for intermediate express api what will be present in the config folder ?

@jpee0316 3 года назад

And the validation folder is for? validation for like form inputs?

@flouainan 4 месяца назад

Hey bro, can you please tell the name of this VScode icon extension ? Brazilian hug 😎

@laviray5447 8 месяцев назад

What I personally prefer is creating separate folder for each function/component like Auth, user, pages, etc.

@theaxacall 3 года назад

hey hi I made an api with express. and the pictures are on the same port.. I can access the links of my pictures from a different server, but I can't show the pictures.

@Jefferson4026 2 года назад

would you make a simple real example using this advanced structure? or if you sell it in a course it would be great :(

@mansilaad2062 3 года назад

What are different design patterns?

@franciscog.6396 3 года назад

Hi Pedro! Nice video. I have a question, how to upload a project with front and back to GitHub? Frontend and Backend in the same repository?

@franciscog.6396 3 года назад

In the project, I have the "client" folder (React Native), and the "server" folder (API REST with MySQL).

@PedroTechnologies 3 года назад

I always recommend separating the repositories!

@PedroTechnologies 3 года назад

I would separate the repos and upload the client to the google play store and the server to either aws, zeet, or heroku!

@franciscog.6396 3 года назад

@@PedroTechnologies thank you so much bro!

@PanlasangMotour 3 года назад

Next Please Service workers :) PWA = Progressive web applications ;)

@PedroTechnologies 3 года назад

I love PWA's so I can definitely make a video on it!

@makermaker9525 Год назад

Can you give me a links for projects that follow intermediate and advanced structure

@skymer7471 Год назад

Shouldn't controllers, services & models be grouped together per "domain" (or entity) api>users>(user.service.ts, user.model.ts, user.controller.ts) ? When the project will grow it will be easier to find what you're searching for

@bestblackpeoplevine7907 3 года назад

can you do video on JEST / Testing

@sunilkumar-zf4dx 2 года назад

nice video, can you put git links for these folder structures with some boilerplate code.

@PedroTechnologies 2 года назад

This was a long time ago so I don't know if I still have the folder with all of this. But I can defo create one and put the link!

@khandoor7228 3 года назад

How did you make that sweet intro? Pls do a video on that!

@PedroTechnologies 3 года назад

Hahaha I didn’t make it! I paid an awesome person on fiver to make it for me. Trying to improve the video quality!

@khandoor7228 3 года назад

@@PedroTechnologies ah gotcha good thinking

@dawid_dahl 3 года назад

You only mention validation in the controllers. I personally do my validation in a middleware. Does that mean that to divide up my files into controllers and services is unnecessary? Feels like there are more to controllers than validation. If you could shed some more light on controllers/services and how to think about that-if one is using that pattern, I know it is not a must-that would be really helpful. Thank you!

@PedroTechnologies 3 года назад

I have a validation middleware too! I just create the YUP schema in the validations folder!

@dawid_dahl 3 года назад

That doesn’t answer my question, but thank you anyway.

@NewleadersTech 3 года назад

a new begining.

@PedroTechnologies 3 года назад

Yes!!

@NewleadersTech 3 года назад

@@PedroTechnologies best of best supportive content .We are counting on you .Really appreciated.

@surajsingh3434 2 года назад

@PedroTech Now we have a Clean Architecture. That also needs your attention.

@yohanneskindu8794 Год назад

Guys don't overcomplicate stuff, if you wanna have advanced folder structure, use nest js.

@otis3744 3 месяца назад

People love to say as a beginner dont…. Lmao as a beginner, do because no one cares who long you’ve been coding, they will expect baller level code from you from day 1

@xO_ADX_Ox 2 года назад

Beginner here, I did not understand what it is used for .env =(

@dueft4479 Год назад

I don't like that you keep your versions in the repo. I would rather use github and add a commit or some kind of tag where I say that this is the v1 of the api. Then I can easily update to that commit if I need v1. But if I keep it in the repo there is a lot of dead code. On the one hand your approach is more comfortable, but the approach I would use is cleaner imo.

@chaitany.a 2 года назад

MVC is an architectural patter, not a design pattern

@luksproject7142 2 года назад

como tu conseguiu ficar sem sotaque?

@amwpagon 2 года назад

i think ddd folder bester than mvc folder

@simonblurton8009 19 дней назад

A folder called helpers is bullshit. It's a dumping ground with no meaning. Modules is better, then if you have a "helper" to do with dates you make a fold in modules called dates. Then we can have more functions to do with dates. Think node_modules, it's how the people that wrote node thought about scalability