📓 DevJournal

DevJournal is a sophisticated, local-first markdown journal designed specifically for developers. It combines the simplicity of markdown with the power of modern AI to help you document your daily progress, optimize your thoughts, and interact with your personal knowledge base.

Italiano | English

---

✨ Features

• 📝 Markdown-First Editor: Rich text editing with full Markdown support, syntax highlighting for code blocks, and live preview.
• 🤖 Multi-Provider AI Integration: Use your favorite AI models from Google Gemini, Anthropic (Claude), or OpenAI (ChatGPT).
• ⚡ AI Optimization: Professionally re-elaborate your notes with a single click while maintaining your original intent. Supports English and Italian.
• 🕒 Revision History & Undo: Never lose a thought. DevJournal maintains a history of your notes, allowing you to revert changes effortlessly.
• 📸 Multimedia Support: Capture images and record audio transcriptions directly into your journal entries with a robust mobile-optimized transcription engine.
• 📅 Calendar Navigation: Intuitive calendar view to browse your entries chronologically.
• 💬 AI Chat Assistant: Chat with your journal entries. Ask questions about your past thoughts, summarize progress, or brainstorm new ideas.
• 🔒 Private & Local-First: Your data stays on your machine. All notes and API keys are stored securely in your browser's local storage.
• 💾 Backup & Portability: Easily export and import your entire journal as a single JSON file.
• 📱 Responsive Design & Dark Mode: Optimized for both desktop and mobile use with full Dark Mode support.
• 🌍 Bilingual (i18n): Full support for English and Italian.

🚀 Getting Started

Prerequisites

• Node.js (v18 or higher)
• pnpm (recommended) or npm

Installation

1. Clone the repository:

   git clone https://github.com/your-username/journaling-dev.git
   cd journaling-dev

2. Install dependencies:

   pnpm install

3. Start the development server:

   pnpm dev

4. Open http://localhost:3000 in your browser.

⚙️ Configuration

To enable AI features, go to the Settings menu and enter your API keys for the desired providers:

• Google Gemini: Get your key at AI Studio.
• OpenAI: Get your key at OpenAI Dashboard.
• Anthropic: Get your key at Anthropic Console.

You can also specify custom model IDs (e.g., gpt-4o, claude-3-5-sonnet, gemini-1.5-pro) for each provider.

🛠️ Tech Stack

• Frontend: React 19, TypeScript
• Styling: Tailwind CSS 4
• State Management: Zustand
• Icons: Lucide React, Iconoir
• Markdown: React Markdown, Remark GFM
• Linter: Biome

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🇮🇹 Italiano

DevJournal è un diario markdown sofisticato, local-first, progettato specificamente per gli sviluppatori. Combina la semplicità del markdown con la potenza dell'IA moderna per aiutarti a documentare i tuoi progressi quotidiani, ottimizzare i tuoi pensieri e interagire con la tua base di conoscenza personale.

✨ Funzionalità

• 📝 Editor Markdown-First: Editing di testo ricco con supporto Markdown completo, evidenziazione della sintassi per i blocchi di codice e anteprima live.
• 🤖 Integrazione AI Multi-Provider: Usa i tuoi modelli AI preferiti di Google Gemini, Anthropic (Claude) o OpenAI (ChatGPT).
• ⚡ Ottimizzazione AI: Rielabora professionalmente le tue note con un solo clic mantenendo il tuo intento originale. Supporta Italiano e Inglese.
• 🕒 Cronologia Revisioni & Annulla: Non perdere mai un pensiero. DevJournal mantiene una cronologia delle tue note, permettendoti di ripristinare le modifiche senza sforzo.
• 📸 Supporto Multimediale: Cattura immagini e registra trascrizioni audio direttamente nelle tue voci del diario con un motore di trascrizione ottimizzato per mobile.
• 📅 Navigazione Calendario: Vista calendario intuitiva per sfogliare le tue voci cronologicamente.
• 💬 Assistente Chat AI: Chatta con le tue voci del diario. Poni domande sui tuoi pensieri passati, riassumi i progressi o fai brainstorming di nuove idee.
• 🔒 Privato & Local-First: I tuoi dati rimangono sulla tua macchina. Tutte le note e le chiavi API sono memorizzate in modo sicuro nel localStorage del tuo browser.
• 💾 Backup & Portabilità: Esporta e importa facilmente l'intero diario come un singolo file JSON.
• 📱 Design Responsive & Dark Mode: Ottimizzato per l'uso sia su desktop che su mobile con supporto completo alla Dark Mode.
• 🌍 Bilingue (i18n): Supporto completo per Italiano e Inglese.

🚀 Per Iniziare

Prerequisiti

• Node.js (v18 o superiore)
• pnpm (raccomandato) o npm

Installazione

1. Clona il repository:

   git clone https://github.com/your-username/journaling-dev.git
   cd journaling-dev

2. Installa le dipendenze:

   pnpm install

3. Avvia il server di sviluppo:

   pnpm dev

4. Apri http://localhost:3000 nel tuo browser.

⚙️ Configurazione

Per abilitare le funzionalità AI, vai nel menu Impostazioni e inserisci le tue chiavi API per i provider desiderati:

• Google Gemini: Ottieni la tua chiave su AI Studio.
• OpenAI: Ottieni la tua chiave sulla Dashboard OpenAI.
• Anthropic: Ottieni la tua chiave sulla Console Anthropic.

Puoi anche specificare ID modello personalizzati (es: gpt-4o, claude-3-5-sonnet, gemini-1.5-pro) per ogni provider.

🛠️ Tech Stack

• Frontend: React 19, TypeScript
• Styling: Tailwind CSS 4
• State Management: Zustand
• Icone: Lucide React, Iconoir
• Markdown: React Markdown, Remark GFM
• Linter: Biome

📄 Licenza

Questo progetto è licenziato sotto la Licenza MIT - vedi il file LICENSE file per i dettagli.

---

Creato con ❤️ per gli sviluppatori che amano scrivere.