aosky / picpic

A awesome image host service driven by github pages and github actions.

picpic

An awesome image host service driven by github pages and github actions.

Doc

EN | 中文文档

Installation

Install via npm:

$ npm i @matrixage/picpic

Usage

To use picpic, by below steps:

• mkdir a folder & cd it
• npm init & press enter through
• npm i @matrixage/picpic
• "init": "picpic init" into package.json scripts
• npm run init
• drop you images to assets folder
• git commit & git push to you github

then active your gh-pages:

if your acccout do not active github actions, you should active github actions and git push again to trigger delopy process.

if your github repo first branch is master,please change the branch in .github/workflows/ci.yml (main => master)

Preview

Tricks

click image to preview detail:

click top-right icon folder to preview images in mode[folder]:

mobile is avaible when you visit site use mobile:

also, more you can explore:

• list mode
• search
• navigator
• minim file system

if you have more demands, and if you think your demands reasonal, you can talk to me.

Dev route

• support picpic.config.json
• support imagemin

Accessibility

Picpic supports the all modern browsers,and you can preview picpic images in chrome or firefox.

License

Picpic is licensed under the MIT license. (http://opensource.org/licenses/MIT)