Skip to content

Commit d6de7ee

Browse files
authored
DOCS: Adds Readme and Icon (#20)
* docs: Writes a readme * docs: Adds icon * docs: adds pretty picture
1 parent cbd1632 commit d6de7ee

File tree

2 files changed

+108
-4
lines changed

2 files changed

+108
-4
lines changed

.github/README.md

+108-4
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,122 @@
1-
2-
# Web Check API
1+
<h1 align="center">Web Check API</h1>
2+
<p align="center">
3+
<a href="https://github.com/lissy93/web-check">
4+
<img width="72" src="./web-check.png?raw=true" />
5+
<br />
6+
</a>
7+
<i>A light-weight Go API for discovering website data</i><br />
8+
<b><a href="https://web-check.xyz">Web Check</a> - <i>Gives you Xray Vision for any Website</i></b>
9+
</p>
310

411
> [!NOTE]
512
> This is a very early work in progress, and is not yet feature complete or production ready.
613
> Stay tuned!
714
8-
### Start Server
15+
---
16+
17+
## Usage
18+
19+
### Developing
20+
21+
#### Getting Started
22+
23+
You will need [git](https://git-scm.com/) and [go](https://go.dev/) installed.
24+
Then clone the repo and download dependencies.
25+
26+
```
27+
git clone git@github.com:xray-web/web-check-api.git
28+
cd web-check-api
29+
go mod download
30+
```
31+
32+
#### Start Server
933

1034
```
1135
make run
1236
```
1337

14-
### Run Tests
38+
#### Run Tests
1539

1640
```
1741
make test
1842
```
43+
44+
45+
### Deploying
46+
47+
#### Option 1: From Source
48+
49+
Follow the setup instructions above. Then build the binaries.
50+
Then execute the output executable directly (e.g. `./bin/app`)
51+
52+
```
53+
make build
54+
```
55+
56+
#### Option 2: From Docker
57+
58+
```
59+
docker run -p 8080:8080 lissy93/web-check-api
60+
```
61+
62+
#### Option 3: Download Executable
63+
From the releases tab, download the compiled binary for your system, and execute it.
64+
65+
---
66+
67+
## License
68+
69+
> _**[Web Check](https://github.com/Lissy93/web-check)** is licensed under [MIT](https://github.com/xray-web/web-check-api/blob/HEAD/LICENSE) © [Alicia Sykes](https://aliciasykes.com) 2024._<br>
70+
> <sup align="right">For information, see <a href="https://tldrlegal.com/license/mit-license">TLDR Legal > MIT</a></sup>
71+
72+
<details>
73+
<summary>Expand License</summary>
74+
75+
```
76+
The MIT License (MIT)
77+
Copyright (c) Alicia Sykes <alicia@omg.com>
78+
79+
Permission is hereby granted, free of charge, to any person obtaining a copy
80+
of this software and associated documentation files (the "Software"), to deal
81+
in the Software without restriction, including without limitation the rights
82+
to use, copy, modify, merge, publish, distribute, sub-license, and/or sell
83+
copies of the Software, and to permit persons to whom the Software is furnished
84+
to do so, subject to the following conditions:
85+
86+
The above copyright notice and this permission notice shall be included install
87+
copies or substantial portions of the Software.
88+
89+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
90+
INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANT ABILITY, FITNESS FOR A
91+
PARTICULAR PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
92+
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
93+
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
94+
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
95+
```
96+
97+
</details>
98+
99+
100+
<!-- License + Copyright -->
101+
<p align="center">
102+
<i>© <a href="https://aliciasykes.com">Alicia Sykes</a> 2024</i><br>
103+
<i>Licensed under <a href="https://gist.github.com/Lissy93/143d2ee01ccc5c052a17">MIT</a></i><br>
104+
<a href="https://github.com/lissy93"><img src="https://i.ibb.co/4KtpYxb/octocat-clean-mini.png" /></a><br>
105+
<sup>Thanks for visiting :)</sup>
106+
</p>
107+
108+
<!-- Dinosaurs are Awesome -->
109+
<!--
110+
. - ~ ~ ~ - .
111+
.. _ .-~ ~-.
112+
//| \ `..~ `.
113+
|| | } } / \ \
114+
(\ \\ \~^..' | } \
115+
\`.-~ o / } | / \
116+
(__ | / | / `.
117+
`- - ~ ~ -._| /_ - ~ ~ ^| /- _ `.
118+
| / | / ~-. ~- _
119+
|_____| |_____| ~ - . _ _~_-_
120+
-->
121+
122+

.github/web-check.png

3.21 KB
Loading

0 commit comments

Comments
 (0)