mirror of
https://github.com/Frooodle/Stirling-PDF.git
synced 2025-11-16 01:21:16 +01:00
# Description of Changes Please provide a summary of the changes, including: ## Add PDF File Association Support for Tauri App ### 🎯 **Features Added** - PDF file association configuration in Tauri - Command line argument detection for opened files - Automatic file loading when app is launched via "Open with" - Cross-platform support (Windows/macOS) ### 🔧 **Technical Changes** - Added `fileAssociations` in `tauri.conf.json` for PDF files - New `get_opened_file` Tauri command to detect file arguments - `fileOpenService` with Tauri fs plugin integration - `useOpenedFile` hook for React integration - Improved backend health logging during startup (reduced noise) ### 🧪 **Testing** See * https://v2.tauri.app/start/prerequisites/ * [DesktopApplicationDevelopmentGuide.md](DesktopApplicationDevelopmentGuide.md) ```bash # Test file association during development: cd frontend npm install cargo tauri dev --no-watch -- -- "path/to/file.pdf" ``` For production testing: 1. Build: npm run tauri build 2. Install the built app 3. Right-click PDF → "Open with" → Stirling-PDF 🚀 User Experience - Users can now double-click PDF files to open them directly in Stirling-PDF - Files automatically load in the viewer when opened via file association - Seamless integration with OS file handling --- ## Checklist ### General - [ ] I have read the [Contribution Guidelines](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/CONTRIBUTING.md) - [ ] I have read the [Stirling-PDF Developer Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/DeveloperGuide.md) (if applicable) - [ ] I have read the [How to add new languages to Stirling-PDF](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/HowToAddNewLanguage.md) (if applicable) - [ ] I have performed a self-review of my own code - [ ] My changes generate no new warnings ### Documentation - [ ] I have updated relevant docs on [Stirling-PDF's doc repo](https://github.com/Stirling-Tools/Stirling-Tools.github.io/blob/main/docs/) (if functionality has heavily changed) - [ ] I have read the section [Add New Translation Tags](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/HowToAddNewLanguage.md#add-new-translation-tags) (for new translation tags only) ### UI Changes (if applicable) - [ ] Screenshots or videos demonstrating the UI changes are attached (e.g., as comments or direct attachments in the PR) ### Testing (if applicable) - [ ] I have tested my changes locally. Refer to the [Testing Guide](https://github.com/Stirling-Tools/Stirling-PDF/blob/main/DeveloperGuide.md#6-testing) for more details. --------- Co-authored-by: Connor Yoh <connor@stirlingpdf.com> Co-authored-by: James Brunton <james@stirlingpdf.com> Co-authored-by: James Brunton <jbrunton96@gmail.com>
96 lines
3.2 KiB
TypeScript
96 lines
3.2 KiB
TypeScript
import { Navigate, useLocation } from 'react-router-dom';
|
|
import { useState, useEffect } from 'react';
|
|
import { useOpenedFile } from '@app/hooks/useOpenedFile';
|
|
import { useBackendInitializer } from '@app/hooks/useBackendInitializer';
|
|
import { fileOpenService } from '@app/services/fileOpenService';
|
|
import { useAuth } from '@app/auth/UseSession';
|
|
import { useAppConfig } from '@app/contexts/AppConfigContext';
|
|
import HomePage from '@app/pages/HomePage';
|
|
import Login from '@app/routes/Login';
|
|
|
|
/**
|
|
* Landing component - Smart router based on authentication status
|
|
*
|
|
* If login is disabled: Show HomePage directly (anonymous mode)
|
|
* If user is authenticated: Show HomePage
|
|
* If user is not authenticated: Show Login or redirect to /login
|
|
*/
|
|
export default function Landing() {
|
|
const { session, loading: authLoading } = useAuth();
|
|
const { config, loading: configLoading } = useAppConfig();
|
|
const location = useLocation();
|
|
|
|
const loading = authLoading || configLoading;
|
|
|
|
console.log('[Landing] State:', {
|
|
pathname: location.pathname,
|
|
loading,
|
|
hasSession: !!session,
|
|
loginEnabled: config?.enableLogin,
|
|
});
|
|
|
|
// Initialize backend on app startup
|
|
useBackendInitializer();
|
|
|
|
// Handle file opened with app (Tauri mode)
|
|
const { openedFilePath, loading: openedFileLoading } = useOpenedFile();
|
|
const [openedFile, setOpenedFile] = useState<File | null>(null);
|
|
|
|
// Load opened file once when path is available
|
|
useEffect(() => {
|
|
if (openedFilePath && !openedFileLoading) {
|
|
const loadOpenedFile = async () => {
|
|
try {
|
|
const fileData = await fileOpenService.readFileAsArrayBuffer(openedFilePath);
|
|
if (fileData) {
|
|
// Create a File object from the ArrayBuffer
|
|
const file = new File([fileData.arrayBuffer], fileData.fileName, {
|
|
type: 'application/pdf'
|
|
});
|
|
setOpenedFile(file);
|
|
}
|
|
} catch (error) {
|
|
console.error('Failed to load opened file:', error);
|
|
}
|
|
};
|
|
|
|
loadOpenedFile();
|
|
}
|
|
}, [openedFilePath, openedFileLoading]);
|
|
|
|
// Show loading while checking auth and config
|
|
if (loading) {
|
|
return (
|
|
<div style={{ minHeight: '100vh', display: 'flex', alignItems: 'center', justifyContent: 'center' }}>
|
|
<div className="text-center">
|
|
<div className="animate-spin rounded-full h-8 w-8 border-b-2 border-blue-600 mx-auto mb-3"></div>
|
|
<div className="text-gray-600">
|
|
Loading...
|
|
</div>
|
|
</div>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
// If login is disabled, show app directly (anonymous mode)
|
|
if (config?.enableLogin === false) {
|
|
console.debug('[Landing] Login disabled - showing app in anonymous mode');
|
|
return <HomePage openedFile={openedFile} />;
|
|
}
|
|
|
|
// If we have a session, show the main app
|
|
if (session) {
|
|
return <HomePage openedFile={openedFile} />;
|
|
}
|
|
|
|
// If we're at home route ("/"), show login directly (marketing/landing page)
|
|
// Otherwise navigate to login (fixes URL mismatch for tool routes)
|
|
const isHome = location.pathname === '/' || location.pathname === '';
|
|
if (isHome) {
|
|
return <Login />;
|
|
}
|
|
|
|
// For non-home routes without auth, navigate to login (preserves from location)
|
|
return <Navigate to="/login" replace state={{ from: location }} />;
|
|
}
|