DentClack is a medical web application that makes booking dental appointments easier and quicker from the comfort of your home.
- Project Overview
- Tech Stack
- Teams and Responsibilities
- How To Get Started
- Branching Strategy
- Contribution Rules
- How To Avoid Conflicts
- FAQs
- Author Info
- Coding Guidelines
- Deployment
- Contributing
- Contact
DentClack is a medical web application that aims to help make booking dental appointments quick and easy from the comfort of your home. This is a simple project built under the idea of helping beginners get more familiar with open source. Happy Coding 💙 :) !
- Framework and Tools: NextJS, NodeJS
- Language: TypeScript, JavaScript
- Libraries: SwiperJS, ChartJS, Material Icons
- Styling: Tailwind, Next Font, Next Theme
- Version Control: Git and GitHub
- Responsible for building the user interface using React components.
- Implementing responsive design with Tailwind CSS.
- Ensuring accessibility and cross-browser compatibility.
- Setting up Node.Js API routes.
- Integrating with external APIs for anime data.
- Managing database connections and data flow.
- Writing and maintaining unit and integration tests.
- Performing code reviews and ensuring code quality.
- Conducting user acceptance testing (UAT) and bug tracking.
- Node.js (version 14 or higher)
- npm or yarn
-
Click on the "Fork" to fork the project or click on the second icon at the top right to fork
-
Clone the forked project
git clone https://www.github.com/<your-github-username>/dent-clack
-
Navigate to the project directory
cd dent-clack
-
Run the project on your browser For VSCode
code .
Other Text Editor on Mac
open ~
On Windows
start .
-
Install dependencies:
npm install # or yarn install
6 Running the Development Server
npm run dev
# or
yarn dev
Open application on http://localhost:3000 with your browser to see the result.
- Main Branch: Protected branch. Only the release manager can merge into this branch.
- Develop Branch: Integration branch for feature branches.
- Feature Branches: Branch off from
develop
for new features or bug fixes. Naming convention:feature/feature-name
. - Hotfix Branches: Branch off from
main
for urgent fixes. Naming convention:hotfix/hotfix-name
.
git switch -C feature/your-feature-name
OR
git checkout -b feature/your-feature-name
git add <file-name>
git commit -m <commit-message>
```bash
git push <remote-name e.g origin> feature/your-feature-name
```
- Create a new pull request from your forked repository
- Make a branch for every contribution you wish to make
- Open a pull request after you are done but note DO NOT MERGE it will only be done after the collaboratos have carefully reviewed your work
⚠️ Do NOT remove other content If not necessary⚠️ - If you have any special edits please contact a collaborator
- Code styling wont be heavily enforced but please write readable code
- Don't forget to add your name to the contributors list file
- Make your pull requests in an incremental manner so as to avoid merging bad code
- Read the CONTRIBUTING.md file for detailed information
An easy way to avoid conflicts is to add an 'upstream' for your git repo, as other PR's may be merged while you're working on your branch/fork.
git remote add upstream https://github.com/vin-jex/dent-clack
Verify if new remote has been added by running the command:
git remote -v
To pull any new changes from your parent repo simply run
git merge upstream/main
This will give you any eventual conflicts and allow you to easily solve them in your repo. It's a good idea to use it frequently in between your own commits to make sure that your repo is up to date with its parent.
For more information on syncing forks read this article from Github.
DentClack is licensed under the MIT License - Checkout LICENSE for details.
P.S. Star ⭐ and Share this repository, if you had fun!!! 😊
-
Who can contribute?
- Anyone with a github account and who is signed up for hacktoberfest :)
-
Who are you and why are you doing this?
- I are a programmer from Nigeria Vincent. I'm doing this because I love Open Source and Hacktoberfest. I want to make it easier for people to get started with Hacktoberfest and Open Source.
-
Why are you not using digitalocean?
- Because we only know JavaScript and suck at servers :).
-
How many pull request (PR) must be made, if I want to get an awesome tshirt from Hacktoberfest 2022?
- 4
-
How do I track my progress to get an awesome shirt from Hacktoberfest 2022?
- go to : (Check Out Your Own Stats at Right Top)
-
What is the duration of Hacktoberfest 2022?
- It is from 1st october to 31st october 2022...
-
What is the event for?
- For the open source community engagement