|
| 1 | +<a name="readme-top"></a> |
| 2 | + |
| 3 | +<!-- |
| 4 | +!!! IMPORTANT !!! |
| 5 | +This README is an example of how you could professionally present your codebase. |
| 6 | +Writing documentation is a crucial part of your work as a professional software developer and cannot be ignored. |
| 7 | +
|
| 8 | +You should modify this file to match your project and remove sections that don't apply. |
| 9 | +
|
| 10 | +REQUIRED SECTIONS: |
| 11 | +- Table of Contents |
| 12 | +- About the Project |
| 13 | + - Built With |
| 14 | + - Live Demo |
| 15 | +- Getting Started |
| 16 | +- Authors |
| 17 | +- Future Features |
| 18 | +- Contributing |
| 19 | +- Show your support |
| 20 | +- Acknowledgements |
| 21 | +- License |
| 22 | +
|
| 23 | +OPTIONAL SECTIONS: |
| 24 | +- FAQ |
| 25 | +
|
| 26 | +After you're finished please remove all the comments and instructions! |
| 27 | +
|
| 28 | +For more information on the importance of a professional README for your repositories: https://github.com/microverseinc/curriculum-transversal-skills/blob/main/documentation/articles/readme_best_practices.md |
| 29 | +--> |
| 30 | + |
| 31 | +<div align="center"> |
| 32 | + <!-- You are encouraged to replace this logo with your own! Otherwise you can also remove it. --> |
| 33 | + <img src="murple_logo.png" alt="logo" width="140" height="auto" /> |
| 34 | + <br/> |
| 35 | + |
| 36 | + <h3><b>Microverse README Template</b></h3> |
| 37 | + |
| 38 | +</div> |
| 39 | + |
| 40 | +<!-- TABLE OF CONTENTS --> |
| 41 | + |
| 42 | +# 📗 Table of Contents |
| 43 | + |
| 44 | +- [📖 About the Project](#about-project) |
| 45 | + - [🛠 Built With](#built-with) |
| 46 | + - [Tech Stack](#tech-stack) |
| 47 | + - [Key Features](#key-features) |
| 48 | + - [🚀 Live Demo](#live-demo) |
| 49 | +- [💻 Getting Started](#getting-started) |
| 50 | + - [Prerequisites](#prerequisites) |
| 51 | + - [Setup](#setup) |
| 52 | + - [Install](#install) |
| 53 | + - [Usage](#usage) |
| 54 | + - [Run tests](#run-tests) |
| 55 | + - [Deployment](#deployment) |
| 56 | +- [👥 Authors](#authors) |
| 57 | +- [🔭 Future Features](#future-features) |
| 58 | +- [🤝 Contributing](#contributing) |
| 59 | +- [⭐️ Show your support](#support) |
| 60 | +- [🙏 Acknowledgements](#acknowledgements) |
| 61 | +- [❓ FAQ (OPTIONAL)](#faq) |
| 62 | +- [📝 License](#license) |
| 63 | + |
| 64 | +<!-- PROJECT DESCRIPTION --> |
| 65 | + |
| 66 | +# 📖 [your_project_name] <a name="about-project"></a> |
| 67 | + |
| 68 | +> Describe your project in 1 or 2 sentences. |
| 69 | +
|
| 70 | +**[your_project__name]** is a... |
| 71 | + |
| 72 | +## 🛠 Built With <a name="built-with"></a> |
| 73 | + |
| 74 | +### Tech Stack <a name="tech-stack"></a> |
| 75 | + |
| 76 | +> Describe the tech stack and include only the relevant sections that apply to your project. |
| 77 | +
|
| 78 | +<details> |
| 79 | + <summary>Client</summary> |
| 80 | + <ul> |
| 81 | + <li><a href="https://reactjs.org/">React.js</a></li> |
| 82 | + </ul> |
| 83 | +</details> |
| 84 | + |
| 85 | +<details> |
| 86 | + <summary>Server</summary> |
| 87 | + <ul> |
| 88 | + <li><a href="https://expressjs.com/">Express.js</a></li> |
| 89 | + </ul> |
| 90 | +</details> |
| 91 | + |
| 92 | +<details> |
| 93 | +<summary>Database</summary> |
| 94 | + <ul> |
| 95 | + <li><a href="https://www.postgresql.org/">PostgreSQL</a></li> |
| 96 | + </ul> |
| 97 | +</details> |
| 98 | + |
| 99 | +<!-- Features --> |
| 100 | + |
| 101 | +### Key Features <a name="key-features"></a> |
| 102 | + |
| 103 | +> Describe between 1-3 key features of the application. |
| 104 | +
|
| 105 | +- **[key_feature_1]** |
| 106 | +- **[key_feature_2]** |
| 107 | +- **[key_feature_3]** |
| 108 | + |
| 109 | +<p align="right">(<a href="#readme-top">back to top</a>)</p> |
| 110 | + |
| 111 | +<!-- LIVE DEMO --> |
| 112 | + |
| 113 | +## 🚀 Live Demo <a name="live-demo"></a> |
| 114 | + |
| 115 | +> Add a link to your deployed project. |
| 116 | +
|
| 117 | +- [Live Demo Link](https://google.com) |
| 118 | + |
| 119 | +<p align="right">(<a href="#readme-top">back to top</a>)</p> |
| 120 | + |
| 121 | +<!-- GETTING STARTED --> |
| 122 | + |
| 123 | +## 💻 Getting Started <a name="getting-started"></a> |
| 124 | + |
| 125 | +> Describe how a new developer could make use of your project. |
| 126 | +
|
| 127 | +To get a local copy up and running, follow these steps. |
| 128 | + |
| 129 | +### Prerequisites |
| 130 | + |
| 131 | +In order to run this project you need: |
| 132 | + |
| 133 | +<!-- |
| 134 | +Example command: |
| 135 | +
|
| 136 | +```sh |
| 137 | + gem install rails |
| 138 | +``` |
| 139 | + --> |
| 140 | + |
| 141 | +### Setup |
| 142 | + |
| 143 | +Clone this repository to your desired folder: |
| 144 | + |
| 145 | +<!-- |
| 146 | +Example commands: |
| 147 | +
|
| 148 | +```sh |
| 149 | + cd my-folder |
| 150 | + git clone git@github.com:myaccount/my-project.git |
| 151 | +``` |
| 152 | +---> |
| 153 | + |
| 154 | +### Install |
| 155 | + |
| 156 | +Install this project with: |
| 157 | + |
| 158 | +<!-- |
| 159 | +Example command: |
| 160 | +
|
| 161 | +```sh |
| 162 | + cd my-project |
| 163 | + gem install |
| 164 | +``` |
| 165 | +---> |
| 166 | + |
| 167 | +### Usage |
| 168 | + |
| 169 | +To run the project, execute the following command: |
| 170 | + |
| 171 | +<!-- |
| 172 | +Example command: |
| 173 | +
|
| 174 | +```sh |
| 175 | + rails server |
| 176 | +``` |
| 177 | +---> |
| 178 | + |
| 179 | +### Run tests |
| 180 | + |
| 181 | +To run tests, run the following command: |
| 182 | + |
| 183 | +<!-- |
| 184 | +Example command: |
| 185 | +
|
| 186 | +```sh |
| 187 | + bin/rails test test/models/article_test.rb |
| 188 | +``` |
| 189 | +---> |
| 190 | + |
| 191 | +### Deployment |
| 192 | + |
| 193 | +You can deploy this project using: |
| 194 | + |
| 195 | +<!-- |
| 196 | +Example: |
| 197 | +
|
| 198 | +```sh |
| 199 | +
|
| 200 | +``` |
| 201 | + --> |
| 202 | + |
| 203 | +<p align="right">(<a href="#readme-top">back to top</a>)</p> |
| 204 | + |
| 205 | +<!-- AUTHORS --> |
| 206 | + |
| 207 | +## 👥 Authors <a name="authors"></a> |
| 208 | + |
| 209 | +> Mention all of the collaborators of this project. |
| 210 | +
|
| 211 | +👤 **Author1** |
| 212 | + |
| 213 | +- GitHub: [@githubhandle](https://github.com/githubhandle) |
| 214 | +- Twitter: [@twitterhandle](https://twitter.com/twitterhandle) |
| 215 | +- LinkedIn: [LinkedIn](https://linkedin.com/in/linkedinhandle) |
| 216 | + |
| 217 | +👤 **Author2** |
| 218 | + |
| 219 | +- GitHub: [@githubhandle](https://github.com/githubhandle) |
| 220 | +- Twitter: [@twitterhandle](https://twitter.com/twitterhandle) |
| 221 | +- LinkedIn: [LinkedIn](https://linkedin.com/in/linkedinhandle) |
| 222 | + |
| 223 | +<p align="right">(<a href="#readme-top">back to top</a>)</p> |
| 224 | + |
| 225 | +<!-- FUTURE FEATURES --> |
| 226 | + |
| 227 | +## 🔭 Future Features <a name="future-features"></a> |
| 228 | + |
| 229 | +> Describe 1 - 3 features you will add to the project. |
| 230 | +
|
| 231 | +- [ ] **[new_feature_1]** |
| 232 | +- [ ] **[new_feature_2]** |
| 233 | +- [ ] **[new_feature_3]** |
| 234 | + |
| 235 | +<p align="right">(<a href="#readme-top">back to top</a>)</p> |
| 236 | + |
| 237 | +<!-- CONTRIBUTING --> |
| 238 | + |
| 239 | +## 🤝 Contributing <a name="contributing"></a> |
| 240 | + |
| 241 | +Contributions, issues, and feature requests are welcome! |
| 242 | + |
| 243 | +Feel free to check the [issues page](../../issues/). |
| 244 | + |
| 245 | +<p align="right">(<a href="#readme-top">back to top</a>)</p> |
| 246 | + |
| 247 | +<!-- SUPPORT --> |
| 248 | + |
| 249 | +## ⭐️ Show your support <a name="support"></a> |
| 250 | + |
| 251 | +> Write a message to encourage readers to support your project |
| 252 | +
|
| 253 | +If you like this project... |
| 254 | + |
| 255 | +<p align="right">(<a href="#readme-top">back to top</a>)</p> |
| 256 | + |
| 257 | +<!-- ACKNOWLEDGEMENTS --> |
| 258 | + |
| 259 | +## 🙏 Acknowledgments <a name="acknowledgements"></a> |
| 260 | + |
| 261 | +> Give credit to everyone who inspired your codebase. |
| 262 | +
|
| 263 | +I would like to thank... |
| 264 | + |
| 265 | +<p align="right">(<a href="#readme-top">back to top</a>)</p> |
| 266 | + |
| 267 | +<!-- FAQ (optional) --> |
| 268 | + |
| 269 | +## ❓ FAQ (OPTIONAL) <a name="faq"></a> |
| 270 | + |
| 271 | +> Add at least 2 questions new developers would ask when they decide to use your project. |
| 272 | +
|
| 273 | +- **[Question_1]** |
| 274 | + |
| 275 | + - [Answer_1] |
| 276 | + |
| 277 | +- **[Question_2]** |
| 278 | + |
| 279 | + - [Answer_2] |
| 280 | + |
| 281 | +<p align="right">(<a href="#readme-top">back to top</a>)</p> |
| 282 | + |
| 283 | +<!-- LICENSE --> |
| 284 | + |
| 285 | +## 📝 License <a name="license"></a> |
| 286 | + |
| 287 | +This project is [MIT](./LICENSE) licensed. |
| 288 | + |
| 289 | +_NOTE: we recommend using the [MIT license](https://choosealicense.com/licenses/mit/) - you can set it up quickly by [using templates available on GitHub](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/adding-a-license-to-a-repository). You can also use [any other license](https://choosealicense.com/licenses/) if you wish._ |
| 290 | + |
| 291 | +<p align="right">(<a href="#readme-top">back to top</a>)</p> |
0 commit comments