docs: add project README
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
86
README.md
86
README.md
@@ -1,42 +1,58 @@
|
|||||||
# sv
|
# 2eInk
|
||||||
|
|
||||||
Everything you need to build a Svelte project, powered by [`sv`](https://github.com/sveltejs/cli).
|
Convert images to optimized screensavers for e-ink devices. Runs entirely in your browser - no uploads, no server.
|
||||||
|
|
||||||
## Creating a project
|
## Features
|
||||||
|
|
||||||
If you're seeing this, you've probably already done this step. Congrats!
|
- **Device Presets** - Pre-configured settings for Kindle, Kobo, reMarkable, and Boox devices
|
||||||
|
- **Batch Processing** - Convert multiple images at once with parallel Web Workers
|
||||||
|
- **Privacy First** - All processing happens locally using WebAssembly
|
||||||
|
- **Customizable Pipeline** - Adjust brightness, contrast, gamma, dithering, and more
|
||||||
|
- **Live Preview** - Compare original and processed images with an interactive slider
|
||||||
|
- **Multiple Dithering Algorithms** - Floyd-Steinberg, Atkinson, and ordered dithering
|
||||||
|
|
||||||
```sh
|
## Supported Devices
|
||||||
# create a new project
|
|
||||||
npx sv create my-app
|
| Brand | Models |
|
||||||
|
|-------|--------|
|
||||||
|
| Kindle | Paperwhite 5, Paperwhite 4, Oasis 3, Scribe, Basic (2022) |
|
||||||
|
| Kobo | Clara 2E, Libra 2, Sage |
|
||||||
|
| reMarkable | reMarkable 2 |
|
||||||
|
| Boox | Note Air |
|
||||||
|
|
||||||
|
Custom device configurations are also supported.
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
1. Select your e-reader from the device dropdown
|
||||||
|
2. Drop images onto the upload area (JPG, PNG, or WebP)
|
||||||
|
3. Adjust pipeline settings if needed (optional)
|
||||||
|
4. Download individual images or all as a ZIP
|
||||||
|
|
||||||
|
## Tech Stack
|
||||||
|
|
||||||
|
- **Framework** - SvelteKit with Svelte 5 runes
|
||||||
|
- **Styling** - Tailwind CSS v4
|
||||||
|
- **Image Processing** - Photon (Rust/WebAssembly)
|
||||||
|
- **Parallelization** - Web Workers with worker pool
|
||||||
|
- **Icons** - Lucide
|
||||||
|
|
||||||
|
## Development
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Install dependencies
|
||||||
|
pnpm install
|
||||||
|
|
||||||
|
# Start dev server
|
||||||
|
pnpm dev
|
||||||
|
|
||||||
|
# Build for production
|
||||||
|
pnpm build
|
||||||
|
|
||||||
|
# Preview production build
|
||||||
|
pnpm preview
|
||||||
```
|
```
|
||||||
|
|
||||||
To recreate this project with the same configuration:
|
## License
|
||||||
|
|
||||||
```sh
|
MIT
|
||||||
# recreate this project
|
|
||||||
pnpm dlx sv@0.15.3 create --template minimal --types ts --add prettier eslint tailwindcss="plugins:none" sveltekit-adapter="adapter:static" mcp="ide:claude-code+setup:local" --install pnpm .
|
|
||||||
```
|
|
||||||
|
|
||||||
## Developing
|
|
||||||
|
|
||||||
Once you've created a project and installed dependencies with `npm install` (or `pnpm install` or `yarn`), start a development server:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
npm run dev
|
|
||||||
|
|
||||||
# or start the server and open the app in a new browser tab
|
|
||||||
npm run dev -- --open
|
|
||||||
```
|
|
||||||
|
|
||||||
## Building
|
|
||||||
|
|
||||||
To create a production version of your app:
|
|
||||||
|
|
||||||
```sh
|
|
||||||
npm run build
|
|
||||||
```
|
|
||||||
|
|
||||||
You can preview the production build with `npm run preview`.
|
|
||||||
|
|
||||||
> To deploy your app, you may need to install an [adapter](https://svelte.dev/docs/kit/adapters) for your target environment.
|
|
||||||
|
|||||||
Reference in New Issue
Block a user