React is all about components. Better structure helps you to easily debug your app, understand how the flow is going on and also as your project grows it becomes easy to manage everything. Now, React doesn't care how you structure your project and components. So in this blog, I am going to share how I structure my project and components.
Let's get started
Before we start
- In this article, I don't use any styling framework just plain CSS(sass).
- Also plain react ๐ .
File structure
If you like this structure you can download it from here.
Apart from configurations actual react project starts from the src/
folder. So let's directly jump into it.
โโโ src/
โโโ app/
โโโ assets/
โ โโโ images/
โโโ common/
โ โโโ Footer/
โ โ โโโ components
โ โโโ Hooks/
โ โโโ Navigation/
โ โ โโโ components
โ โโโ UIElements/
โ โ โโโ LoadingAnimations/
โ โโโ Util/
โโโ pages/
โ โโโ 404/
โ โโโ About/
โ โ โโโ components/
โ โ โโโ About.jsx
โ โโโ Contact/
โ โ โโโ components/
โ โ โโโ Contact.jsx
โ โโโ Home/
โ โโโ components/
โ โโโ Home.jsx
โโโ styles/
โโโ _mixins.scss
โโโ _variables.scss
I always separate client and server logic even for a small project because it helps to focus on one thing and it makes the project less messy.
Quickly know what each folder contains:
- app/ - This folder contains actual react app.
- common/ - This folder contains components that can be used anywhere in the project.
- pages/ - This folder contains all the common pages of the website.
- assets/ - All the assets like images, audios etc.
- styles/ - This folder contains global styles like Sass variables, mixins, functions etc.
Let's dig deep
Pages
.
โโโ pages/
โโโ components/
โ โโโ Hero.jsx
โ โโโ Hero.scss
โ โโโ CTA.jsx
โ โโโ CTS.scss
โโโ Home.jsx
So, here Home.jsx
is a route and page. The idea is to imagine each page as a separate HTML file and it contains different sections as components.
Common
.
โโโ common/
โโโ Footer/
โโโ Hooks/
โโโ Navigation/
โโโ UIElements/
โโโ Util/
Common folder contains components that are used by other components like loading animations, custom buttons, custom hooks etc.
App
The app folder contains the main app with all the features like the dashboard, profile page etc. So you can think app folder like the actual app that unlocks after login.
Component Structure
Now let's take a look at how I structure a component.
Naming
Component name, the file name that contains the component, style sheet file name of the respective component will be the same.
Here's how I structure a component-
For example,
import react, { useState, useEffect } from 'React';
import axios from 'axios';
import 'CompName.scss';
const CompName = (props) => {
const [visits, setVisits] = useState(0);
const [color, setColor] = useState('red');
const name = "Cat";
useEffect(() => {
setVisits(1);
});
const someFunction = () => {
// do something
};
return (
<div>
<h1>Visits: {visits}</h1>
</div>
);
};
export default CompName;
That's it!
โ๏ธ Tool of the week โ๏ธ
While designing a website we get confused about what to include on different pages. For example, what all things need to be included on the pricing page? Here comes this website to rescue.
Thanks for reading, follow for more ๐.