Skip to content

Commit

Permalink
Update README
Browse files Browse the repository at this point in the history
  • Loading branch information
pjborowiecki committed Aug 23, 2023
1 parent b47e613 commit 1830a4a
Showing 1 changed file with 161 additions and 12 deletions.
173 changes: 161 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,47 @@
<div>
<h1 align="center">ARKA</h1>
<h3 align="center">Veterinary Clinic Landing Pagen and Appointment Booking System</h3>
<p align="center">
<a href="https://github.com/pjborowiecki/ARKA-Veterinary-Clinic-Landing-Page-and-Appointment-Booking-System.git/issues">Report Bug</a>
·
<a href="https://github.com/pjborowiecki/ARKA-Veterinary-Clinic-Landing-Page-and-Appointment-Booking-System.git/issues">Request Feature</a>
</p>
</div>

<!-- TABLE OF CONTENTS -->
<details>
<summary>Table of Contents</summary>
<ol>
<li><a href="#about-the-project">About The Project</a></li>
<li><a href="#feedback-received">Tech Stack</a></li>
<li><a href="getting-started">Getting Started</li>
<li><a href="#contributing">Contributing</a></li>
<li><a href="#license">License</a></li>
<li><a href="#contact">Contact</a></li>
<li><a href="#todos">ToDo</li>
</ol>
</details>

<!-- ABOUT THE PROJECT -->

## About the Project

[https://arka-weterynaria.pl](https://arka-weterynaria.pl)
<br>

![public/images/screenshot](./public/images/screenshots/screenshot.png)
<br>

This project is a re-build of the [Arka Weterynaria](https://arka-weterynaria.pl) website I receintly build with [Remix](https://remix.run/) and [MongoDB Atlas](https://www.mongodb.com/atlas/database) for one of my clients in Poland. I decided to re-build it with the latest and greatest in tech for my own learning purposes. This project is still in development. Please check back soon.
This project is a re-build of the [Arka Weterynaria](https://arka-weterynaria.pl) website I receintly build with [Remix](https://remix.run/) and [MongoDB Atlas](https://www.mongodb.com/atlas/database) for one of my clients in Poland. I decided to re-build it with the latest and greatest in tech for my own learning purposes.

The original website was desined by me in Figma and built with Remix and MongoDB Atlas. The client wanted a simple website with a contact form and a full booking management system, where he would be able to confirm or reject bookings and notify the client via email. The website is hosted on Vercel. When completed, I intend to replace the original website with this rebuild.

### Tech Stack
**<u>This project is currently in development. Please check back soon.</u>**

<p align="right">(<a href="#readme-top">back to top</a>)</p>
<br>

## Tech Stack

- **Framework:** [Next.js 13](https://nextjs.org)
- **Styling:** [Tailwind CSS](https://tailwindcss.com)
Expand All @@ -18,22 +51,138 @@ The original website was desined by me in Figma and built with Remix and MongoDB
- **Authentication:** [Clerk](https://clerk.com)
- **Forms:** [React Hook Form](https://react-hook-form.com)
- **Email:** [React Email](https://react.email)
- **Validation:** [Zod](https://zod.dev/)
- **Validations:** [Zod](https://zod.dev/)
- **Hosting:** [Vercel](https://vercel.com)
- **Project Management:** [Jira](https://www.atlassian.com/software/jira)

<p align="right">(<a href="#readme-top">back to top</a>)</p><br>

## Getting Started <br><br>

#### Prerequisites:

- [Node.js (version 18 or higher)](https://nodejs.org)
- [pNPM](https://pnpm.io) (alternatively, you can use npm or yarn)
<br>

#### Installation:

<br>

1. Clone the repo

```sh
git clone https://github.com/pjborowiecki/ARKA-Veterinary-Clinic-Landing-Page-and-Appointment-Booking-System.git
```

<br>

2. Install the required packages

```sh
pnpm install
```

<br>

3. Rename a `.env.example` file in the project's root directory and fill in the required values. See below for details on obtaining the keys:
<br>
- **Clerk:** <br><br>
- Create a new account with [Clerk](https://clerk.com)
- _ToDo:_ Complete the setup instructions <br><br>
- **PlanetScale:** <br><br>
- Create a new account with [PlanetScale](https://planetscale.com)
- _ToDo:_ Complete the setup instructions <br><br>
- **PlanetScale:** <br><br>
- Create a new account with [Resend](https://resend.com)
- _ToDo:_ Complete the setup instructions <br><br>
<p align="right">(<a href="#readme-top">back to top</a>)</p><br>
### TODO:
#### Development: <br><br>
1. Start the development server
```sh
pnpm dev
```
<br>
2. Your app should be available at [http://localhost:3000](https://localhost:3000)
<br>
<p align="right">(<a href="#readme-top">back to top</a>)</p><br>
#### Deployment:
ToDo: Complete the deployment instructions
<p align="right">(<a href="#readme-top">back to top</a>)</p>
<br>
## Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Run code linting (`pnpm lint`)
5. Run code formatting (`pnpm format`)
6. Push to the Branch (`git push origin feature/AmazingFeature`)
7. Open a Pull Request

<p align="right">(<a href="#readme-top">back to top</a>)</p>
<br>

<!-- LICENSE -->

## License

Distributed under the MIT License.

<p align="right">(<a href="#readme-top">back to top</a>)</p>

<!-- CONTACT -->

## Contact

Piotr Borowiecki - [@pjborowiecki](https://www.linkedin.com/in/pjborowiecki/) - hello@pjborowiecki.com

<p align="right">(<a href="#readme-top">back to top</a>)</p>
<br>

<!-- TODO -->

## ToDo

- [ ] Fix urls and paths (dashboard, reservations, settings, etc.)
- [ ] Decide on the type of time slots and update the data schema
- [ ] Fix server actions
- [ ] Implement the landing page:
- [ ] Add a navbar
- [x] Add navbar
- [ ] Add mobile menu
- [ ] Add a hero section
- [ ] Add a services section
- [ ] Add a contact section
- [ ] Add a footer
- [x] Add hero section
- [x] Add about section
- [ ] Add services section
- [ ] Add contact section
- [ ] Add footer
- [ ] Investigate the opacity issue (e.g., /10)
- [ ] Add a favicon
- [ ] Add favicon
- [ ] Add OpenGRaph image (og.jpg)
- [ ] Add a robots.txt file
- [ ] Add a sitemap.xml file
- [ ] Add robots.txt file
- [ ] Add sitemap.xml file
- [ ] Add site description in siteConfig
- [ ] Improve README

<p align="right">(<a href="#readme-top">back to top</a>)</p>

0 comments on commit 1830a4a

Please sign in to comment.