{ Gisto }

Snippets made awesome

About
Getting gisto
Future and Status
Screenshots
Features
Gisto previous version
Latest builds
Issues, bug reporting and pull requests
Privacy/authentication
How to help/contribute
Development setup
Run tests
Release cycle
License

About

Gisto is a code snippet manager that runs on GitHub Gists and adds additional features such as searching, tagging and sharing gists while including a rich code editor. All your data is stored on GitHub and you can access it from GitHub Gists at any time with changes carrying over to Gisto

Getting gisto

You can download Gisto for (macOS, Windows, Linux) desktop from our website or from releases tab
Use featured Web based client available at: https://web.gistoapp.com

Future and Status

Current released version is always on the branch master

Gisto next version in the works can be tracked via next branch

Please see next branch for upcoming version currently in development.

change.log of current version for more detailed info regarding new features, bug fixes and releases.

Changelog

Screenshots


Dashboard	Snippet view	Snippet options

Edit mode	Settings	Create new

CSV preview	GeoJSON preview	Images preview

FEATURES

Advanced search
Enterprise log-in
Tags
Syntax highlight
Grouping by language
Quick snippet actions
Copy to clipboard
Copy file contents to clipboard
Open in external tools like plunkr, jsbin, carbon.now.sh, jsfiddle, etc.
Editor settings
Theme color changer
Drag and drop to create files
Comments
Web app
Open source

Preview of:

Markdown preview (with emoji)
AsciiDoc preview
CSV and TSV preview
GeoJSON preview
Images preview (read only, pushed to gist by git)
PDF preview (read only, pushed to gist by git)
Open API/Swagger preview

And more...

Gisto previous version

Gisto v1 can be tracked via branch v1

This version considered obsolete and will not be updated

Latest builds

Latest builds in the releases tab

Issues, bug reporting and pull requests

Please feel free to add a bug / feature request / suggestions to the issue tracker.

Pull requests are very welcome

Privacy/authentication

Gisto authenticates to GitHub by using one of the following methods:

Oauth2 - the default option on the log-in screen
Basic authentication over SSL and retrieving an oAuth2 token. Thus the need for your GitHub user and password
Access token - If you would rather to supply your own access token without providing Gisto your login details you may manually create an access token from the account settings at GitHub and login using the generated token
Token via CLI - You can log-in with token by passing it to the executable as CLI argument (macOs example): open /Applications/Gisto.app/ --args --token 123123 (#183)

Gisto only saves the oAuth2 token received after authenticating and nothing else.

This token will be saved permanently until you log out.

You can find out more at the F.A.Q. section

How to help/contribute

fix issues, pull request are very welcome
write, improve docs
write tests (we use jest)
fix/contribute to Gisto's website (https://gistoapp.com)
suggest features and improvements
spread the word

Development setup

Make sure you have nodejs and npm installed in the development machine

Clone the latest "next" branch:

git clone -b next --single-branch https://github.com/Gisto/Gisto.git

Install dependencies in the directory created by cloning:

npm install

Run the local application (electron mode):

npm run dev

Run the local application (webapp):

npm run start:web (you will also have to run webserver from /web/ directory)

(for more commands, see package.json script section)

Run tests

npm run test or npm t

Release cycle

pre-release (beta from next branch)

make changes on next brnch ONLY
commit (this will run lint and tests)
do not push, run npm run make:release:beta - will commit new tag with -beta.0 prefix and will also push

release

make changes on next brnch ONLY
commit (this will run lint and tests) and push
do not push, run npm run make:release (for minor version), will update readme and changelog, add and commit new tag and will also push

License

MIT

nape1/Gisto