|
| 1 | +<!-- PROJECT LOGO --> |
| 2 | +<br /> |
| 3 | +<p align="center"> |
| 4 | + <h1 align="center">Developer's Portfolio ✨</h1> |
| 5 | + |
| 6 | + <p align="center"> |
| 7 | + It is a personal static website/portfolio template hosted with GitHub Pages, built to showcase my recent projects. |
| 8 | + <br /> |
| 9 | + <strong>Site URL / Demo » </strong> |
| 10 | + <a href="https://hashirshoaeb.github.io/portfolio"> hashirshoaeb.github.io/portfolio</a> |
| 11 | + <br /> |
| 12 | + <br /> |
| 13 | + <a href="https://hashirshoaeb.com">About Me</a> |
| 14 | + · |
| 15 | + <a href="https://github.com/hashirshoaeb/portfolio/issues">Report Bug</a> |
| 16 | + · |
| 17 | + <a href="https://github.com/hashirshoaeb/portfolio/issues">Request Feature</a> |
| 18 | + </p> |
| 19 | +</p> |
| 20 | + |
| 21 | +[](https://github.com/hashirshoaeb/portfolio/network) |
| 22 | +[](https://github.com/hashirshoaeb/portfolio/blob/master/LICENSE) |
| 23 | +[](https://twitter.com/hashirshoaeb) |
| 24 | +[](https://nodejs.org) |
| 25 | +[](https://nodejs.org) |
| 26 | + |
| 27 | + |
| 28 | +<!-- TABLE OF CONTENTS --> |
| 29 | +<details> |
| 30 | + <summary>Table of Contents</summary> |
| 31 | + <ol> |
| 32 | + <li> |
| 33 | + <a href="#about-the-project">About The Project</a> |
| 34 | + </li> |
| 35 | + <li> |
| 36 | + <a href="#getting-started">Getting Started</a> |
| 37 | + <ul> |
| 38 | + <li><a href="#prerequisites">Prerequisites</a></li> |
| 39 | + <li><a href="#setup">Setup</a></li> |
| 40 | + </ul> |
| 41 | + </li> |
| 42 | + <li><a href="#support-my-work">Support my work</a></li> |
| 43 | + <li><a href="#contributing">Contributing</a></li> |
| 44 | + <li><a href="#license">License</a></li> |
| 45 | + </ol> |
| 46 | +</details> |
| 47 | + |
| 48 | + |
| 49 | + |
| 50 | +<!-- ABOUT THE PROJECT --> |
| 51 | +# About The Project |
| 52 | + |
| 53 | +[](https://example.com) |
| 54 | + |
| 55 | +There are many portfolio website templates available on Github, however, I didn't find one that really suit my needs so I created this one. A simple, easy to configure, lightweight, and responsive static portfolio website. |
| 56 | + |
| 57 | +I know one template doesn't fulfill everyone's needs. So I'll try adding more features in the near future. You may also suggest changes by forking this repo and creating a pull request or opening an issue. |
| 58 | + |
| 59 | +**Features** |
| 60 | + |
| 61 | +- [x] Easy to configure |
| 62 | +- [x] SEO friendly |
| 63 | +- [x] Responsive |
| 64 | +- [x] Lightweight |
| 65 | +- [x] Linktree Page |
| 66 | + |
| 67 | +**Built with** [Nextjs](https://nextjs.org/) & [Bootstrap5](https://getbootstrap.com). |
| 68 | + |
| 69 | + |
| 70 | + |
| 71 | +<!-- GETTING STARTED --> |
| 72 | +# Getting Started |
| 73 | + |
| 74 | +Building your own personal website from this project can take as little as 30 minutes. Follow the setup instructions below. Please feel free to reach out to me by filing an [issue](https://github.com/hashirshoaeb/portfolio/issues) or emailing me at hashirshoaeb@gmail.com for help configuring your project. |
| 75 | + |
| 76 | +## Prerequisites |
| 77 | + |
| 78 | +You should have [Nodejs](https://nodejs.org/en/) and [Git](https://git-scm.com/downloads) installed on your PC. You should also own a GitHub account. |
| 79 | + |
| 80 | +## Setup |
| 81 | + |
| 82 | +1. Fork this repoistory and clone it to your local machine. |
| 83 | + ```sh |
| 84 | + git clone https://github.com/<your-username>/portfolio.git |
| 85 | + ``` |
| 86 | + |
| 87 | +2. Edit the [config/config.js](https://github.com/hashirshoaeb/portfolio/blob/main/config/config.js) file. Replace [config/profile.png](https://github.com/hashirshoaeb/portfolio/blob/main/config/profile.png) with your image. |
| 88 | + >Note: You need to rename your image file as `profile.png`. |
| 89 | + |
| 90 | +3. Run following scripts in terminal/command prompt to install dependencies. |
| 91 | + ```sh |
| 92 | + npm install |
| 93 | + npm run build |
| 94 | + ``` |
| 95 | +## Testing |
| 96 | + |
| 97 | +1. To test on your local server, run the following command: |
| 98 | + ```sh |
| 99 | + npm run dev |
| 100 | + ``` |
| 101 | + |
| 102 | +2. Open the browser to http://localhost:3000/ |
| 103 | + |
| 104 | +## Deployment |
| 105 | + |
| 106 | +If it works locally, you can deploy your project to GitHub Pages. GitHub Pages provides two types of free domains, `<username>.github.io` and `<username>.github.io/<repository>`. You can choose the one that suits your needs. You can learn more about domain types from [here](https://docs.github.com/en/pages/getting-started-with-github-pages/about-github-pages#types-of-github-pages-sites). |
| 107 | + |
| 108 | +### Deploy to \<your-username>.github.io/portfolio |
| 109 | + |
| 110 | +Simply you just need to commit and push your changes to github. And [GitHub Actions](https://docs.github.com/en/actions/learn-github-actions/introduction-to-github-actions#overview) will take care of the deployment. Your site will be available at `https://<your-username>.github.io/portfolio` |
| 111 | + |
| 112 | +### Deploy to \<your-username>.github.io |
| 113 | + |
| 114 | +Create a new repository with your username as `<your-username>.github.io`. And let the following command do the job for you. |
| 115 | + |
| 116 | +```sh |
| 117 | + npm run predeploy |
| 118 | + node scripts/pages.js <your-username> master |
| 119 | +``` |
| 120 | + |
| 121 | +Your site will be available at `https://<your-username>.github.io` |
| 122 | + |
| 123 | +>Note: You need to replace `<your-username>` with your username. To add CNAME for custom domain, see [scripts/cname.js](https://github.com/hashirshoaeb/portfolio/blob/main/scripts/cname.js) |
| 124 | + |
| 125 | +# Support my work |
| 126 | + |
| 127 | +If you found this project valuable, please consider giving it a ⭐️ on GitHub. Your support keeps me motivated! If you'd like to further support my work, you can buy me a book. Thank you for your generosity! |
| 128 | +
|
| 129 | +<div> |
| 130 | + <a href="https://www.buymeacoffee.com/hashirshoaeb"><img src="https://img.buymeacoffee.com/button-api/?text=Buy me a book&emoji=📖&slug=hashirshoaeb&button_colour=5F7FFF&font_colour=ffffff&font_family=Cookie&outline_colour=000000&coffee_colour=FFDD00" /></a> |
| 131 | + </div> |
| 132 | +
|
| 133 | +<!-- CONTRIBUTING --> |
| 134 | +# Contributing |
| 135 | +
|
| 136 | +Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contribution you make would be **appreciated**. |
| 137 | +
|
| 138 | +1. Fork the Project |
| 139 | +2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`) |
| 140 | +3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`) |
| 141 | +4. Push to the Branch (`git push origin feature/AmazingFeature`) |
| 142 | +5. Open a Pull Request |
| 143 | +
|
| 144 | +
|
| 145 | +
|
| 146 | +<!-- LICENSE --> |
| 147 | +# License |
| 148 | +
|
| 149 | +Distributed under the `MIT` License. See [LICENSE](https://github.com/hashirshoaeb/portfolio/blob/main/LICENSE) for more information. |
0 commit comments