@dytsou/resume-converter 2.0.2

package/.env.example

@@ -0,0 +1,6 @@
+# GitHub Pages deployment flag
+GITHUB_PAGES=true
+
+# Google Drive resume link
+# Your Google Drive share link for the resume download button
+VITE_GOOGLE_DRIVE_RESUME_LINK=https://drive.google.com/file/d/YOUR_FILE_ID/view?usp=sharing

package/.github/dependabot.yml

@@ -0,0 +1,44 @@
+version: 2
+updates:
+  # Enable version updates for npm (works with pnpm)
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "friday"
+      time: "09:00"
+    open-pull-requests-limit: 5
+    reviewers:
+      - "dytsou"
+    assignees:
+      - "dytsou"
+    labels:
+      - "dependencies"
+    commit-message:
+      prefix: "chore(deps):"
+      include: "scope"
+    # Group updates to reduce PR noise
+    groups:
+      production-dependencies:
+        dependency-type: "production"
+      development-dependencies:
+        dependency-type: "development"
+
+  # Enable version updates for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "friday"
+      time: "09:00"
+    open-pull-requests-limit: 5
+    reviewers:
+      - "dytsou"
+    assignees:
+      - "dytsou"
+    labels:
+      - "github-actions"
+    commit-message:
+      prefix: "ci"
+      include: "scope"
+

package/.github/workflows/ci.yml

@@ -0,0 +1,73 @@
+name: CI Checks
+permissions:
+  contents: read
+  pull-requests: read
+
+on:
+  push:  # Runs on push to any branch
+  pull_request:  # Also runs on PRs to any branch
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 20
+
+      - name: Enable Corepack
+        run: corepack enable
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run ESLint
+        run: pnpm run lint
+
+  typecheck:
+    name: Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 20
+
+      - name: Enable Corepack
+        run: corepack enable
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Run TypeScript type check
+        run: pnpm run typecheck
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 20
+
+      - name: Enable Corepack
+        run: corepack enable
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build project
+        run: pnpm run build
+

package/.github/workflows/deploy.yml

@@ -0,0 +1,56 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [ main ]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 20
+
+      - name: Enable Corepack
+        run: corepack enable
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build site (runs converter + vite)
+        run: pnpm run build
+        env:
+          GITHUB_PAGES: 'true'
+          VITE_GOOGLE_DRIVE_RESUME_LINK: ${{ vars.VITE_GOOGLE_DRIVE_RESUME_LINK }}
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: dist
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+

package/.github/workflows/publish.yml

@@ -0,0 +1,241 @@
+name: Publish to npmjs & GitHub Packages
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'package.json'
+      - 'scripts/convert-latex.mjs'
+      - 'index.html'
+  release:
+    types: [created]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      packages: write
+      id-token: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Enable Corepack
+        run: corepack enable
+
+      - name: Get package version
+        id: package-version
+        run: |
+          VERSION=$(node -p "require('./package.json').version")
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "Current package version: $VERSION"
+
+      - name: Get package name
+        id: package-name
+        run: |
+          PACKAGE_NAME=$(node -p "require('./package.json').name")
+          echo "name=$PACKAGE_NAME" >> $GITHUB_OUTPUT
+          echo "Package name: $PACKAGE_NAME"
+
+      - name: Check if version exists on npmjs
+        id: check-npmjs
+        run: |
+          VERSION=${{ steps.package-version.outputs.version }}
+          PACKAGE_NAME=${{ steps.package-name.outputs.name }}
+          if npm view $PACKAGE_NAME@$VERSION version --registry=https://registry.npmjs.org >/dev/null 2>&1; then
+            echo "exists=true" >> $GITHUB_OUTPUT
+            echo "Version $VERSION already exists on npmjs, will skip npmjs publish"
+          else
+            echo "exists=false" >> $GITHUB_OUTPUT
+            echo "Version $VERSION is new on npmjs, will publish"
+          fi
+        continue-on-error: true
+
+      - name: Check if version exists on GitHub Packages
+        id: check-github
+        run: |
+          VERSION=${{ steps.package-version.outputs.version }}
+          PACKAGE_NAME=${{ steps.package-name.outputs.name }}
+          npm config set @dytsou:registry https://npm.pkg.github.com
+          npm config set //npm.pkg.github.com/:_authToken ${{ secrets.GITHUB_TOKEN }}
+          if npm view $PACKAGE_NAME@$VERSION version --registry=https://npm.pkg.github.com >/dev/null 2>&1; then
+            echo "exists=true" >> $GITHUB_OUTPUT
+            echo "Version $VERSION already exists on GitHub Packages, will skip GitHub Packages publish"
+          else
+            echo "exists=false" >> $GITHUB_OUTPUT
+            echo "Version $VERSION is new on GitHub Packages, will publish"
+          fi
+        continue-on-error: true
+
+      - name: Verify package
+        if: steps.check-npmjs.outputs.exists == 'false' || steps.check-github.outputs.exists == 'false'
+        run: |
+          npm pack --dry-run
+
+      # 1) Publish to npmjs
+      - name: Publish to npmjs
+        if: steps.check-npmjs.outputs.exists == 'false'
+        id: publish-npmjs
+        run: |
+          npm config set registry https://registry.npmjs.org
+          npm config set //registry.npmjs.org/:_authToken ${{ secrets.NPM_TOKEN }}
+          npm publish --access public || {
+            PACKAGE_NAME=${{ steps.package-name.outputs.name }}
+            VERSION=${{ steps.package-version.outputs.version }}
+            if npm view $PACKAGE_NAME@$VERSION version --registry=https://registry.npmjs.org >/dev/null 2>&1; then
+              echo "Version already exists, skipping publish"
+              exit 0
+            else
+              echo "Publish failed for unknown reason"
+              exit 1
+            fi
+          }
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        continue-on-error: true
+
+      # 2) Publish to GitHub Packages
+      - name: Publish to GitHub Packages
+        if: steps.check-github.outputs.exists == 'false'
+        id: publish-github
+        run: |
+          npm config set registry https://npm.pkg.github.com
+          npm config set @dytsou:registry https://npm.pkg.github.com
+          npm config set //npm.pkg.github.com/:_authToken ${{ secrets.GITHUB_TOKEN }}
+          npm publish || {
+            PACKAGE_NAME=${{ steps.package-name.outputs.name }}
+            VERSION=${{ steps.package-version.outputs.version }}
+            if npm view $PACKAGE_NAME@$VERSION version --registry=https://npm.pkg.github.com >/dev/null 2>&1; then
+              echo "Version already exists, skipping publish"
+              exit 0
+            else
+              echo "Publish failed for unknown reason"
+              exit 1
+            fi
+          }
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        continue-on-error: true
+
+      - name: Check if release should be created
+        id: should-create-release
+        run: |
+          NPMJS_PUBLISHED=false
+          GITHUB_PUBLISHED=false
+          NPMJS_SKIPPED=false
+          GITHUB_SKIPPED=false
+          
+          # Check if npmjs was published in this run
+          if [ "${{ steps.check-npmjs.outputs.exists }}" == "false" ] && [ "${{ steps.publish-npmjs.outcome }}" == "success" ]; then
+            NPMJS_PUBLISHED=true
+          elif [ "${{ steps.check-npmjs.outputs.exists }}" == "true" ]; then
+            NPMJS_SKIPPED=true
+          fi
+          
+          # Check if GitHub Packages was published in this run
+          if [ "${{ steps.check-github.outputs.exists }}" == "false" ] && [ "${{ steps.publish-github.outcome }}" == "success" ]; then
+            GITHUB_PUBLISHED=true
+          elif [ "${{ steps.check-github.outputs.exists }}" == "true" ]; then
+            GITHUB_SKIPPED=true
+          fi
+          
+          # Create release if:
+          # 1. Any registry was published in this run, OR
+          # 2. GitHub Packages was published (even if npmjs was skipped because it already exists)
+          if [ "$NPMJS_PUBLISHED" == "true" ] || [ "$GITHUB_PUBLISHED" == "true" ]; then
+            echo "should_create=true" >> $GITHUB_OUTPUT
+            echo "Should create release: npmjs_published=$NPMJS_PUBLISHED, github_published=$GITHUB_PUBLISHED, npmjs_skipped=$NPMJS_SKIPPED, github_skipped=$GITHUB_SKIPPED"
+          else
+            echo "should_create=false" >> $GITHUB_OUTPUT
+            echo "Skipping release creation - no new publishes (both may already exist)"
+          fi
+
+      - name: Create GitHub Release
+        if: steps.should-create-release.outputs.should_create == 'true'
+        uses: softprops/action-gh-release@v1
+        with:
+          tag_name: v${{ steps.package-version.outputs.version }}
+          name: v${{ steps.package-version.outputs.version }}
+          prerelease: ${{ contains(steps.package-version.outputs.version, 'beta') || contains(steps.package-version.outputs.version, 'alpha') || contains(steps.package-version.outputs.version, 'rc') }}
+          body: |
+            ## ${{ steps.package-name.outputs.name }}@${{ steps.package-version.outputs.version }}
+            
+            **Published to multiple registries:**
+            
+            - **npmjs.com**: https://www.npmjs.com/package/${{ steps.package-name.outputs.name }}
+            
+            - **GitHub Packages**: https://github.com/${{ github.repository }}/packages
+            
+            *Note: If a registry already had this version, it was skipped. Only missing registries were published.*
+            
+            ### Installation
+            
+            **From npmjs (default):**
+            
+            ```bash
+            npm install -g ${{ steps.package-name.outputs.name }}
+            
+            # or
+            
+            pnpm install -g ${{ steps.package-name.outputs.name }}
+            ```
+            
+            **From GitHub Packages:**
+            
+            First, create or update your `.npmrc` file:
+            
+            ```ini
+            @dytsou:registry=https://npm.pkg.github.com
+            //npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN
+            ```
+            
+            Then install:
+            
+            ```bash
+            npm install -g ${{ steps.package-name.outputs.name }}
+            
+            # or
+            
+            pnpm install -g ${{ steps.package-name.outputs.name }}
+            ```
+          generate_release_notes: true
+          draft: false
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Publish summary
+        if: always()
+        run: |
+          echo "## Publish Summary"
+          echo "### npmjs"
+          if [ "${{ steps.check-npmjs.outputs.exists }}" == "true" ]; then
+            echo "Skipped - version already exists"
+          elif [ "${{ steps.publish-npmjs.outcome }}" == "success" ]; then
+            echo "Published successfully"
+          elif [ "${{ steps.publish-npmjs.outcome }}" == "failure" ]; then
+            echo "Failed to publish"
+          else
+            echo "Skipped - not attempted"
+          fi
+          echo ""
+          echo "### GitHub Packages"
+          if [ "${{ steps.check-github.outputs.exists }}" == "true" ]; then
+            echo "Skipped - version already exists"
+          elif [ "${{ steps.check-github.outputs.exists }}" == "false" ] && [ "${{ steps.publish-github.outcome }}" == "success" ]; then
+            echo "Published successfully"
+          elif [ "${{ steps.publish-github.outcome }}" == "failure" ]; then
+            echo "Failed to publish"
+          else
+            echo "Skipped - not attempted"
+          fi
+

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Tsou, Dong-You
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,186 @@
+# LaTeX to HTML Converter with Automated Deployment
+
+A specialized web application that converts LaTeX resume documents to clean, professional HTML and deploys them to GitHub Pages. The system automatically processes your LaTeX resume and creates a beautiful, responsive web version with proper styling and typography.
+
+## Features
+
+- **Automated LaTeX Resume Conversion**: Converts `.tex` resume files to professional HTML with proper formatting
+- **Resume-Specific Styling**: Clean, professional presentation optimized for resume content
+- **CI/CD Pipeline**: GitHub Actions workflow that validates and deploys automatically
+- **Fail-Safe Deployment**: Blocks deployment if any LaTeX file fails to convert
+- **Document Browser**: Browse all converted documents in a clean, responsive interface
+- **MathJax Integration**: Proper rendering of mathematical formulas
+
+## Project Structure
+
+```
+resume/
+├── latex/                  # Store your LaTeX resume files here
+│   └── resume.tex          # Main LaTeX resume document
+├── scripts/
+│   └── convert-latex.mjs   # LaTeX to HTML conversion script
+├── src/
+│   ├── App.tsx             # Main application
+│   ├── main.tsx           # React entry point
+│   └── index.css          # Global styles
+├── public/
+│   ├── converted-docs/     # Generated HTML files (created during build)
+│   └── documents-manifest.json  # Document metadata (created during build)
+├── dist/                   # Production build output
+└── .github/
+    └── workflows/
+        └── deploy.yml      # CI/CD pipeline configuration
+```
+
+## Getting Started
+
+### 1. Add Your LaTeX Documents
+
+Place your `.tex` files in the `latex/` directory. The converter will automatically process all files with a `.tex` extension.
+
+Example structure:
+```
+latex/
+├── my-research-paper.tex
+├── math-notes.tex
+└── thesis.tex
+```
+
+### 2. Test Locally
+
+Convert and build the project:
+
+```bash
+pnpm install
+pnpm run convert  # Convert LaTeX files only
+pnpm run build    # Convert + build entire project
+```
+
+### 3. Set Up GitHub Pages
+
+1. Go to your GitHub repository settings
+2. Navigate to **Pages** section
+3. Under **Source**, select "GitHub Actions"
+
+### 4. Configure Environment Variables
+
+Add your credentials as repository variables for GitHub Actions:
+
+1. Go to **Settings** > **Variables** > **Variables** tab
+2. Click **New repository variable**
+3. Add the following variables:
+   - `VITE_GOOGLE_DRIVE_RESUME_LINK`: Your Google Drive share link for the resume (optional)
+
+### 5. Push to Deploy
+
+```bash
+git add .
+git commit -m "Add LaTeX documents"
+git push origin main
+```
+
+The GitHub Actions workflow will:
+1. Install dependencies
+2. Convert all LaTeX files
+3. Validate conversion success
+4. Build the React application
+5. Deploy to GitHub Pages (only if all conversions succeed)
+
+## How It Works
+
+### Conversion Process
+
+1. **LaTeX Parsing**: Uses `@unified-latex` to parse LaTeX source
+2. **HTML Generation**: Converts LaTeX AST to HTML with proper structure
+3. **MathJax Integration**: Mathematical formulas are rendered client-side
+4. **Styling**: Applies arXiv-inspired CSS for clean academic presentation
+5. **Manifest Creation**: Generates a JSON file with document metadata
+
+### CI/CD Pipeline
+
+The GitHub Actions workflow (`.github/workflows/deploy.yml`) ensures:
+
+- All LaTeX files convert successfully before deployment
+- Build fails if any conversion errors occur
+- Only successfully built sites are deployed to GitHub Pages
+- Environment variables are properly injected during build
+
+### Database Tracking
+
+The Supabase database stores:
+
+- **Documents Table**: Metadata about each LaTeX file (title, author, date)
+- **Conversion Logs**: History of conversion attempts and errors
+
+## Available Scripts
+
+- `pnpm run dev` - Start development server
+- `pnpm run convert` - Convert LaTeX files to HTML
+- `pnpm run build` - Convert LaTeX + build production bundle
+- `pnpm run preview` - Preview production build locally
+- `pnpm run lint` - Run ESLint
+
+## Customization
+
+### Changing Base Path
+
+If your repository name is different, update `vite.config.ts`:
+
+```typescript
+base: process.env.GITHUB_PAGES === 'true' ? '/your-repo-name/' : '/',
+```
+
+### Styling
+
+Modify the CSS in `scripts/convert-latex.mjs` to customize the HTML output appearance.
+
+### Document Metadata
+
+The converter extracts metadata from LaTeX commands:
+- `\title{...}` - Document title
+- `\author{...}` - Author names
+- `\date{...}` - Publication date
+
+## Deployment
+
+Your site will be available at:
+```
+https://<username>.github.io/<repository-name>/
+```
+
+## Troubleshooting
+
+### Conversion Fails
+
+Check the GitHub Actions logs to see which LaTeX file failed and why. Common issues:
+- Unsupported LaTeX packages
+- Syntax errors in LaTeX source
+- Missing closing braces
+
+### Deployment Blocked
+
+If deployment is blocked, the CI/CD pipeline detected conversion failures. Fix the LaTeX files and push again.
+
+### Local Testing
+
+Run the conversion locally to debug issues:
+```bash
+pnpm run convert
+```
+
+Check the generated files in `public/converted-docs/` and review `public/documents-manifest.json`.
+
+## Technologies Used
+
+- **React + TypeScript**: Frontend framework
+- **Vite**: Build tool and dev server
+- **@unified-latex**: LaTeX parsing and conversion
+- **MathJax**: Mathematical notation rendering
+- **Supabase**: Database for tracking conversions
+- **GitHub Actions**: CI/CD automation
+- **GitHub Pages**: Static site hosting
+- **Source Sans Pro**: Typography
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package/eslint.config.js

@@ -0,0 +1,28 @@
+import js from '@eslint/js';
+import globals from 'globals';
+import reactHooks from 'eslint-plugin-react-hooks';
+import reactRefresh from 'eslint-plugin-react-refresh';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  { ignores: ['dist'] },
+  {
+    extends: [js.configs.recommended, ...tseslint.configs.recommended],
+    files: ['**/*.{ts,tsx}'],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: globals.browser,
+    },
+    plugins: {
+      'react-hooks': reactHooks,
+      'react-refresh': reactRefresh,
+    },
+    rules: {
+      ...reactHooks.configs.recommended.rules,
+      'react-refresh/only-export-components': [
+        'warn',
+        { allowConstantExport: true },
+      ],
+    },
+  }
+);

package/index.html

@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="en">
+
+<head>
+  <meta charset="UTF-8" />
+  <link rel="icon" type="image/png" href="/assets/favicon.png" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Resume</title>
+
+<body>
+  <div id="root"></div>
+  <script type="module" src="/src/main.tsx"></script>
+</body>
+
+</html>