Skip to content

Commit 68eca53

Browse files
committed
modified readme
1 parent 415541a commit 68eca53

File tree

1 file changed

+37
-33
lines changed

1 file changed

+37
-33
lines changed

README.md

Lines changed: 37 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,26 @@
11
Snippet-Fu
22
==========
33
Snippet-Fu lets you store and copy frequently used snippets
4-
of text quickly. All data is stored offline in your own computer
5-
and absolutely nothing is tracked or communicated over the
6-
network.
4+
of text quickly by copying to clipboard with just one click.
5+
All data is stored offline in your own computer and absolutely
6+
nothing is tracked or communicated over the network.
77

8-
Unlike storing in text files or notes, Snippet-Fu will copy
9-
the text to clipboard with one click and doesn't require you
10-
to select it first removing chances of over-typing and errors.
11-
Unlike clipboard managers, it will only keep what you explicitly
8+
In analytics, development or even business, we often have to
9+
repeatedly re-use long or complicated text like command lines,
10+
database connection strings etc. Using ad-hoc solutions like
11+
text editors or note-taking apps to store these is fidgety
12+
due to having to select the text to copy to clipboard and
13+
error-prone due to risk of accidental overtyping.
14+
15+
Snippet-Fu prioritizes simple finding and re-use of text
16+
by simply clicking on the stored text and has a search
17+
function to quickly find what you are looking for. Unlike
18+
clipboard managers, it will only keep what you explicitly
1219
put into it and won't monitor your clipboard.
1320

1421
The snippets are stored as a plain JSON file in your local
15-
data folder and the program has simple options to export your
16-
data. Do not save passwords in Snippet-Fu.
22+
data folder. Click the information icon to see the location
23+
where the file is stored. Do not save passwords in Snippet-Fu.
1724

1825
History
1926
-------
@@ -27,18 +34,15 @@ Screenshots
2734
![Snippet-Fu screenshot](screenshot.png)
2835

2936

30-
Building and Running
31-
--------------------
32-
This project is based on [Electron](http://electron.atom.io/)
33-
and built using [React](https://facebook.github.io/react/)
34-
components. It uses [Create React App](https://github.com/facebookincubator/create-react-app)
35-
to bootstrap the react components. The workflow for building
36-
the app and development is mentioned below.
37+
Building
38+
--------
39+
This project is based on [Electron](http://electron.atom.io/) with
40+
[Electron Builder](https://www.electron.build/), [React](https://facebook.github.io/react/)
41+
and [Material Components for Web](https://github.com/material-components/material-components-web-react/). It uses [Create React App](https://github.com/facebookincubator/create-react-app)
42+
to bootstrap the react components and a modified version of the workflow
43+
explained in [Kitze's blog]((https://medium.com/@kitze/%EF%B8%8F-from-react-to-an-electron-app-ready-for-production-a0468ecb1da3)
44+
to integrate CRA with Electron.
3745

38-
- Make sure Electron is installed in your system
39-
```
40-
npm install -g electron
41-
```
4246
- Clone the repository into a suitable location on the drive
4347
```
4448
git clone https://github.com/srinathh/snippetfu.git
@@ -47,26 +51,26 @@ the app and development is mentioned below.
4751
```
4852
cd snippetfu
4953
50-
npm install
54+
yarn
5155
```
5256

53-
- Build the project using react-scripts
57+
- To devlop locally, run the following yarn script
5458
```
55-
npm run build
59+
yarn electron-dev
5660
```
57-
- Run electron on the build directory
61+
62+
- To build the packed application, use the following script which calls `electron-builder`
63+
and packs executables for Linux, Mac & Windows. The Linux build is well tested,
64+
Windows builds lightly tested & Mac un-tested. Testers & contributors welcome!
5865
```
59-
electron build
66+
yarn electron-pack -mwl
6067
```
61-
Development Notes
68+
69+
Changes from Version 1
6270
------------------
63-
- For development, should uncomment this line in `main.js` to show dev tools
64-
```
65-
// win.webContents.openDevTools()
66-
```
67-
- In a number of places, you may see `window.require()`. This is to prevent
68-
conflict between NodeJS `require()` that is used by webpack in create-react-app
69-
and `require()` supported by Electron at runtime.
71+
- Integrated workflow between Electron & React
72+
- New UI library - official React adapters of Material Components for Web
73+
- Simpler architecture & fewer dependencies - specifically no more use of Redux
7074

7175
License
7276
-------

0 commit comments

Comments
 (0)