Skip to content

Commit 71e4bb6

Browse files
authored
Add basic readme (#6)
1 parent 895b9b5 commit 71e4bb6

File tree

3 files changed

+85
-0
lines changed

3 files changed

+85
-0
lines changed

README.md

+85
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
# Snip
2+
3+
Snip is a simple, cross-platform text editor inspired by Boop. It aims to improve on Boop by adding cross-platform support, better handling of large files, enhanced syntax highlighting, and the ability to operate on files. Snip maintains a focus on easy scripting, quick startup, and usefulness as a small notepad for copying and editing snippets.
4+
5+
## Features
6+
7+
- **Cross-Platform Support**: Available on macOS, Windows[^1], and Linux[^1].
8+
- **Handling of Large Files**: Efficiently handles large files without performance degradation.
9+
- **Syntax Highlighting**: Syntax highlighting for various programming languages.
10+
- **File Operations[^1]**: Ability to open, edit, and save files.
11+
- **Easy Scripting**: Simple and powerful scripting capabilities.
12+
- **Quick Startup**: Fast startup time, making it ideal for quick edits.
13+
- **Notepad Functionality**: Useful as a small notepad for copying and editing snippets.
14+
15+
[^1]: Not yet supported, but coming soon
16+
17+
## Screenshots
18+
19+
![Screenshot 1](docs/screenshots/main_dark.png)
20+
![Screenshot 2](docs/screenshots/main_light.png)
21+
22+
## Installation
23+
24+
### macOS
25+
26+
Download the .dmg from the [releases page](https://github.com/SnipEditor/snip/releases). Open the archive and move the Snip application to your 'Applications' folder.
27+
28+
> [!NOTE]
29+
> Opening the archive or opening the application for the first time requires you to open through the context menu in finder, since the application is signed but not notarized
30+
31+
### Windows
32+
33+
TODO: Currently windows support is not yet implemented. Support will arrive in the near future
34+
35+
### Linux
36+
37+
TODO: Currently linux support is not yet implemented. Support will arrive in the near future
38+
39+
## Usage
40+
41+
To start Snip, simply run the binary
42+
43+
## Building from Source
44+
45+
### Prerequisites
46+
47+
- Rust
48+
- Cargo
49+
- Node.js
50+
- Yarn
51+
52+
### Steps
53+
54+
1. Clone the repository:
55+
56+
```bash
57+
git clone https://github.com/SnipEditor/snip.git
58+
cd snip
59+
```
60+
61+
2. Install dependencies:
62+
63+
```bash
64+
yarn install
65+
```
66+
67+
3. Run the application in development mode:
68+
69+
```bash
70+
yarn tauri dev
71+
```
72+
73+
4. (To build a standalone executable):
74+
75+
```bash
76+
yarn tauri build
77+
```
78+
79+
## License
80+
81+
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
82+
83+
## Acknowledgements
84+
85+
- Inspired by [Boop](https://github.com/IvanMathy/Boop)

docs/screenshots/main_dark.png

806 KB
Loading

docs/screenshots/main_light.png

813 KB
Loading

0 commit comments

Comments
 (0)