repos / pico

commit

708c969

parent

08c97df

author

Eric Bower

date

2024-04-22 19:02:01 +0000 UTC

docs: showcase some features

 1@@ -25,6 +25,96 @@ rsync, scp, or sftp. Hopefully you see the trend.
 2   sftp.
 3 - [feeds.sh](https://feeds.sh): An RSS email notification service using SSH.
 4 
 5-## development
 6+## Deploy a site with a single command
 7 
 8-[Local setup](/dev.md)
 9+Upload your static site to us:
10+
11+```bash
12+rsync -rv ./public/ pgs.sh:/mysite/
13+```
14+
15+Now your site is available with TLS handled for you:
16+https://{user}-mysite.pgs.sh We also automatically handle TLS for your custom
17+domains!
18+
19+## Access localhost using https
20+
21+if you have a local webserver on localhost:8000, activate an SSH tunnel to us:
22+
23+```bash
24+ssh -R dev:80:localhost:8000 tuns.sh
25+```
26+
27+Now your local dev server is availble on the web: https://dev.tuns.sh
28+
29+## Publish blog articles with a single command
30+
31+Create your first post, (e.g. `hello-world.md`):
32+
33+```md
34+# hello world!
35+
36+This is my first blog post.
37+
38+Cya!
39+```
40+
41+Upload the post to us:
42+
43+```bash
44+scp hello-world.md prose.sh:/
45+```
46+
47+Congrats! You just published a blog article, accessible here:
48+https://{user}.prose.sh/hello-world
49+
50+## Push and pull docker images using SSH
51+
52+Open a tunnel to our docker registry:
53+
54+```bash
55+ssh -L 1338:localhost:80 -N imgs.sh
56+```
57+
58+Now you are authenticated! You are now able to push and pull like normal:
59+
60+```bash
61+docker push localhost:1338/alpine:latest
62+docker pull localhost:1338/alpine:latest
63+```
64+
65+All images sent to us are private and scoped to your user automatically.
66+
67+## Easily share code snippets
68+
69+Pipe some stdout to us:
70+
71+```bash
72+git diff | ssh pastes.sh changes.patch
73+```
74+
75+And instantly share your code snippets: https://{user}.pastes.sh/changes.patch
76+
77+## Receive email notifications for your favorite rss feeds
78+
79+Create a blogs.txt file:
80+
81+```
82+=: email rss@myemail.com
83+=: digest_interval 1day
84+=> https://pico.prose.sh/rss
85+=> https://erock.prose.sh/rss
86+```
87+
88+Then upload it to us:
89+
90+```bash
91+scp blogs.txt feeds.sh:/
92+```
93+
94+After the daily interval has been reached, you will receive an email with your
95+feeds!
96+
97+## Ready to join?
98+
99+https://pico.sh/getting-started