Skip to content

Commit 3241bd7

Browse files
authored
Merge pull request #55 from TryShape/issue-51-update-readme
Issue 51 update readme
2 parents 4dc62a1 + 240c788 commit 3241bd7

7 files changed

Lines changed: 109 additions & 10 deletions

File tree

README.md

Lines changed: 109 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,12 @@
11

22

33
<p align="center">
4-
<a href="https://tryshape.vercel.app/">
5-
<img src="https://res.cloudinary.com/atapas/image/upload/v1624874245/demos/TryShape-GitHub-icon-only_lwjrc3.png" alt="logo" width="125"/>
4+
<a href="https://tryshape.vercel.app/" target="_blank">
5+
<img src="./public/readme/TryShape-GitHub-icon-only.png" alt="logo" width="125"/>
66
</a>
77

88
<p/>
99

10-
<p align="center">
11-
<img src="https://res.cloudinary.com/atapas/image/upload/v1624876097/demos/tryshape-text-transparent_n8md87.png" width="300" />
12-
</p>
13-
1410
<h4 align="center">Create, Export, Share, and Use any Shapes of your choice.</h4>
1511

1612
<p align="center">
@@ -29,7 +25,7 @@
2925
<a href="https://github.com/TryShape/tryshape/pulls" target="blank">
3026
<img src="https://img.shields.io/github/issues-pr/TryShape/tryshape?style=flat-square" alt="tryshape pull-requests"/>
3127
</a>
32-
<a href="https://twitter.com/intent/tweet?text=Check%20this%20amazing%20app%20https://tryshape.vercel.app/,%20created%20by%20@tapasadhikary%20and%20friends%0A%0A%23DEVCommunity%20%23100DaysOfCode%20%23tryshape"><img src="https://img.shields.io/twitter/url?label=Share%20on%20Twitter&style=social&url=https%3A%2F%2Fgithub.com%2FTryShape%2Ftryshape"></a>
28+
<a href="https://twitter.com/intent/tweet?text=👋%20Check%20this%20amazing%20app%20https://tryshape.vercel.app/,%20created%20by%20@tapasadhikary%20and%20friends%0A%0A%23DEVCommunity%20%23100DaysOfCode%20%23tryshape"><img src="https://img.shields.io/twitter/url?label=Share%20on%20Twitter&style=social&url=https%3A%2F%2Fgithub.com%2FTryShape%2Ftryshape"></a>
3329

3430
</p>
3531

@@ -42,13 +38,22 @@
4238
</p>
4339

4440
## 👋 Introducing `TryShape`
41+
<p align="center">
42+
<a href="https://tryshape.vercel.app" target="blank"/>
43+
<img src="./public/readme/landing.png" alt="landing" />
44+
</a>
45+
</p>
46+
4547
`TryShape` is an opensource platform to create shapes of your choice using a simple, easy-to-use interface. You can create banners, circles, polygonal shapes, export them as SVG, PNG, and even as CSS.
4648

4749
## 🚀 Demo
4850
TBA
4951

5052
## 🔥 Features
5153
`TryShape` comes with a bundle of features to give your creativity a shape. You can do the followings with TryShape,
54+
55+
### ✅ Listing Shapes
56+
- List out shapes for you to pick and use.
5257
### ✅ Create Shapes
5358
- Create any shapes using an intuitive editor.
5459
- Create Polygonal, Circular, Elliptical shapes without knowing the underlying complexities like CSS clip-path.
@@ -77,7 +82,69 @@ TBA
7782
- Features like export, like, create, edit shapes need you to autheticate with the app. You can use your Gmail or GitHub credntials to authenticate to the app. It is secured and powered by `Google Firebase`.
7883

7984
## 🏗️ How to Set up `TryShape` for Development?
80-
TBA
85+
You can run TryShape locally with a few easy steps.
86+
87+
1. Clone the repository
88+
89+
```bash
90+
git clone https://github.com/TryShape/tryshape.git
91+
```
92+
93+
2. Change the working directory
94+
95+
```bash
96+
cd tryshape
97+
```
98+
99+
3. Install dependencies
100+
101+
```bash
102+
npm install # or, yarn install
103+
```
104+
105+
4. Create `.env` file in root and add your variables
106+
107+
```bash
108+
NEXT_PUBLIC_DB_URL= YOUR_HARPER_DB_DATABASE_URL
109+
NEXT_PUBLIC_DB_AUTHORIZATION= YOUR_HARPER_DB_AUTHORIZATION_ID
110+
111+
NEXT_PUBLIC_FIREBASE_AUTHORIZATION=YOUR_FIREBASE_AUTH_KEY
112+
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=YOUR_FIREBASE_AUTH_DOMAIN
113+
NEXT_PUBLIC_FIREBASE_PROJECT_ID=YOUR_FIREBASE_PROJECT_ID
114+
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=YOUR_FIREBASE_PROJECT_BUCKET
115+
NEXT_PUBLIC_FIREBASE_MESSAGING_SERNDER_ID=YOUR_FIREBASE_MESSAGING_SERNDER_ID
116+
NEXT_PUBLIC_FIREBASE_APP_ID=YOUR_FIREBASE_APP_ID
117+
NEXT_PUBLIC_FIREBASE_MEASUREMENT_ID=YOUR_FIREBASE_MEASUREMENT_ID
118+
```
119+
120+
5. Run the app
121+
122+
```bash
123+
npm run dev # or, yarn dev
124+
```
125+
126+
That's All!!! Now open [localhost:3000](http://localhost:3000/) to see the app.
127+
128+
## 🍔 Built With
129+
- [Next JS](https://nextjs.org/): The coolest React-based framework on the planet
130+
- [Harper DB](https://harperdb.io/): A flexible Data Store
131+
- [react-icons](https://react-icons.github.io/react-icons/): One shop for all the icons
132+
- [react-hot-toast](https://react-hot-toast.com/): Super cool toast messages
133+
- [firebase](https://firebase.google.com/): Authentication services
134+
- [date-fns](https://date-fns.org/): Date formatting
135+
- [axios](https://github.com/axios/axios): Makes API calls easy
136+
- [react-bootstrap](https://react-bootstrap.github.io/): A popular frontend framework built-for React
137+
- [Styled Components](https://styled-components.com/): Visual primitives for the component age
138+
- [react-clip-path](https://github.com/atapas/react-clip-path#readme): A home grown module to handle clip-path property in a React app.
139+
- [react-draggable](https://github.com/mzabriskie/react-draggable): Make a HTML element draggable in React
140+
- [react-loader-spinner](https://mhnpd.github.io/react-loader-spinner/): Provides simple React SVG spinner component which can be implemented for async await operation before data loads to the view
141+
- [react-switch](https://github.com/markusenglund/react-switch#readme): A draggable toggle-switch component for React.
142+
- [downloadjs](http://danml.com/download.html): Trigger a download from JavaScript
143+
- [html-to-image](https://github.com/bubkoo/html-to-image#readme): Converts an HTML element to image
144+
- [Vercel](http://vercel.com/): Best for Hosting a Next.js app
145+
146+
## 🛡️ License
147+
This project is licensed under the MIT License - see the [`LICENSE`](LICENSE) file for details.
81148

82149
## 🦄 Upcoming Features
83150
`TryShape` has all the potentials to grow further. Here are some of the upcoming features planned(not in any order),
@@ -92,10 +159,42 @@ TBA
92159
- ✔️ Flexible Datastore
93160
- ✔️ Better Performance
94161
- ✔️ Tagging a shape
162+
- ✔️ Cloning a shape
95163
- ✔️ Provide comment on a shape.
96164
- ✔️ More authetication mechanisms like twitter, facebook, etc.
97165

98166
If you find something is missing, `TryShape` is listening. Please create a feature request [from here](https://github.com/TryShape/tryshape/issues/new/choose).
99167

100-
## 🤝 Contributions
101-
TBA
168+
## 🏃‍♀️ Deploy
169+
170+
<a href="https://vercel.com/new/project?template=https://github.com/TryShape/tryshape">
171+
<img src="https://vercel.com/button" height="37.5px" />
172+
</a>
173+
<a href="https://app.netlify.com/start/deploy?repository=https://github.com/TryShape/tryshape">
174+
<img src="https://www.netlify.com/img/deploy/button.svg" height="37.5px" />
175+
</a>
176+
177+
178+
## 🤝 Contributing to `TryShape`
179+
Any kind of positive contributions are welcome! Please help us to grow by contributing to the project.
180+
181+
If you wish to contribute, you can work on any features [listed here](https://github.com/TryShape/tryshape/tree/issue-51-update-readme#-upcoming-features) or create one on your own. After adding your code, please send us a Pull Request.
182+
183+
> Please read [`CONTRIBUTING`](CONTRIBUTING.md) for details on our [`CODE OF CONDUCT`](CODE_OF_CONDUCT.md), and the process for submitting pull requests to us.
184+
185+
## 🙏 Support
186+
187+
We all need support and motivation. `TryShape` is not an exception. Please give this project a ⭐️ to encourage and show that you liked it. Don't forget to leave a star ⭐️ before you go away.
188+
189+
If you found the app helpful, consider supporting us with a coffee.
190+
191+
<a href="https://www.buymeacoffee.com/greenroots">
192+
<img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" height="50px">
193+
</a>
194+
195+
---
196+
197+
<h3 align="center">
198+
A ⭐️ to <b>TryShape</b> is to build its triceps 💪 stronger.
199+
</h3>
200+
6.11 KB
Loading
5.95 KB
Loading

public/readme/app.png

91 KB
Loading

public/readme/landing.png

179 KB
Loading
14.1 KB
Loading

public/readme/tryshape.png

4.42 KB
Loading

0 commit comments

Comments
 (0)