quicknotes/README.md

# QuickNotes

QuickNotes is a personal knowledge management application that allows you to create, manage, and interlink your notes, save articles for later reading, subscribe to RSS/Atom feeds, upload and view PDF documents, and perform a unified full-text search across all your content. The application also includes an Emacs mode for seamless integration directly from your editor.

## Features

- **Notes**: Create, edit, and delete notes with Markdown support. Interlink notes using wiki-style syntax and visualize connections with an interactive graph.
- **Readlist**: Save and view articles for later reading with automatic content extraction.
- **Feeds**: Subscribe to and manage RSS/Atom feeds, and view feed entries with options to mark them as read or unread.
- **Documents**: Upload and view PDF documents directly within the app without needing to download them.
- **Omnisearch**: Perform unified full-text searches across notes, feed entries, readlist items, and documents.
- **Emacs Integration**: Access QuickNotes features directly from Emacs using a dedicated mode.

## Technology Stack

- **Backend**: Go with the Gin web framework and GORM; SQLite for data storage.
- **Frontend**: Svelte with SvelteKit, styled with Bulma CSS and FontAwesome for icons.
- **Search**: Bleve for full-text search capabilities.
- **PDF Viewing**: Integrated PDF.js-like viewer for inline document viewing.
- **Package Management**: Bun for frontend dependencies and Go modules for backend dependencies.
- **Testing**: Go testing framework for backend and Playwright for end-to-end frontend testing.

## Installation

1. **Server Setup**:
   - Ensure Go is installed.
   - Build the backend server using `go build` or the provided `build.sh` script.
   - Ensure Bun is installed and run `bun install` in the frontend directory.
   - Start the backend server (default URL: `http://localhost:3000`).

2. **Frontend**:
   - The SvelteKit frontend is served by the Go backend after being built, or can be run separately for development.
   - Access the application via your web browser at `http://localhost:3000`.

3. **Emacs Integration**:
   - Place `quicknotes.el` in your Emacs load path.
   - Add `(require 'quicknotes)` to your Emacs configuration.
   - Start QuickNotes within Emacs using `M-x quicknotes`.

## Usage

- Navigate using dedicated pages for Notes, Readlist, Feeds, Documents, and Omnisearch.
- Use the Omnisearch page to perform full-text searches across all content domains.

### Emacs Mode Key Bindings

- `RET`: Open item
- `r`: Mark item as read
- `f`: List feeds
- `l`: List readlist items
- `n`: List notes
- `o`: Toggle between HTML and Org mode rendering (using Pandoc)
- `g`: Refresh content
- `q`: Quit the current buffer

## Documentation

For detailed specifications, see:

- [Architecture](specs/architecture.md)
- [Notes](specs/notes.md)
- [Readlist](specs/readlist.md)
- [Feeds](specs/feeds.md)
- [Documents](specs/documents.md)
- [Omnisearch](specs/omnisearch.md)
- [Database](specs/database.md)
- [API](specs/api.md)
- [Frontend](specs/frontend.md)
- [Authentication](specs/authentication.md)
- [Emacs Integration](specs/emacs_integration.md)

## License

This project is licensed under the MIT License.