This repository contains the frontend code for the Space Ya Tech blog application. The blog frontend is built using React and Vite, and communicates with the backend API to display and manage blog content.
To run the project on to your system, need to have the following installed .
- Node and NPM packages, all latest versions.
- Install appropriate code editor or Interactive Development Environment (IDE)
-
Fork the repo project to your personal account
-
Clone the repo to your local machine/environment
https://github.com/user-name/blog-frontend.git "Using HTTPS" or git@github.com:user-name/blog-frontend.git "Using ssh"
-
cd blog-frontend and install dependencies
npm install
-
Start development server
npm run dev
-
The blog frontend will now be available at
http://localhost:3000
.
- All development will be in reference to our Figma file link
To install Docker:
To run the app using docker:-
Run:
npm run docker:dev
Then go to http://localhost:3000
Alternatively:
- Run the project locally using docker-compose
docker-compose up
- The application should be running on http://localhost:3000
Run:
npm run docker:prod
- Then go to localhost:3000 or the production domain
To contribute to the blog frontend, follow these steps:
- Find an open issue on the issues page that you would like to work on.
- Assign the issue to yourself and create a new branch
git checkout -b branch-name
- Work on the issue by making changes to the codebase.
- Add
git add .
and commitgit commit -m "short and descriptives messages"
your changes - Once you have finished working on the issue, push your changes to GitHub:
git push
- Open a Pull Request on GitHub for your changes to be reviewed and merged into the main branch.
- Make sure to comment on your pull request with any relevant information about your changes.
To add comments to your work on an issue, follow these steps:
-
When working on an issue, make sure to add relevant comments to your code to explain what you are doing.
-
After committing your changes, include a comment in the commit message to explain what changes you made and why.
-
When creating a pull request, make sure to include a summary of your changes and any relevant comments in the description.
-
If your changes address a specific issue, make sure to reference the issue in your pull request description.
-
Once your changes have been reviewed and merged, make sure to close the relevant issue and add a comment to explain how your changes resolved the issue.
For any communication and challenges regarding the project Discussion board is always open
By following these guidelines, you can contribute to the Space Ya Tech blog frontend and help improve the overall user experience of the blog application. Remember to communicate frequently with the other developers in the community and to ask for help or feedback whenever you need it. Together, we can create an amazing blog frontend for the Space Ya Tech community. Team