|
| 1 | +# CLAUDE.md |
| 2 | + |
| 3 | +This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. |
| 4 | + |
| 5 | +## Project Overview |
| 6 | + |
| 7 | +This is a static website for the Web Science conference (https://www.webscience.cz), an annual tech conference held in Brno, Czech Republic. The site is a single-page application that provides information about the conference, program, speakers, tickets, and sponsors. |
| 8 | + |
| 9 | +## Technology Stack |
| 10 | + |
| 11 | +- **Frontend**: Pure HTML5, CSS3, and vanilla JavaScript (no build process) |
| 12 | +- **CSS Framework**: Bootstrap 4.4.1 |
| 13 | +- **JavaScript Libraries**: |
| 14 | + - jQuery 3.4.1 (slim build) |
| 15 | + - iframe-lightbox for video/iframe modals |
| 16 | + - Mapy.cz API for map integration |
| 17 | +- **Hosting**: GitHub Pages (deployed from `gh-pages` branch) |
| 18 | +- **Deployment**: Automated via GitHub Actions on push to `master` |
| 19 | + |
| 20 | +## File Structure |
| 21 | + |
| 22 | +- `index.html` - Main HTML file containing the entire conference website |
| 23 | +- `style.css` - Custom CSS styles (uses Fira Code/Fira Mono fonts) |
| 24 | +- `main.js` - JavaScript for navbar behavior, scroll effects, and menu toggle |
| 25 | +- `img/` - Images directory |
| 26 | + - `speaker/` - Speaker profile photos |
| 27 | + - `partners/` - Partner/sponsor logos |
| 28 | +- `docs/` - PDF documents (Code of Conduct, terms and conditions) |
| 29 | +- `.github/workflows/gh-pages.yml` - GitHub Actions deployment workflow |
| 30 | + |
| 31 | +## Key Features |
| 32 | + |
| 33 | +### Navigation & UX |
| 34 | +- Sticky navbar that appears after scrolling past the welcome section |
| 35 | +- Responsive mobile menu with automatic collapse on link click |
| 36 | +- Scroll-to-top button that appears after scrolling past welcome section |
| 37 | +- Smooth scroll behavior for anchor links |
| 38 | + |
| 39 | +### Content Sections (in order) |
| 40 | +1. **Welcome** - Hero section with conference date and branding |
| 41 | +2. **Program** - Detailed schedule with speaker info and talk descriptions |
| 42 | +3. **Tickets** - Three ticket tiers (Blind/Regular/Late) with Stripe payment integration |
| 43 | +4. **Location** - Venue information with Mapy.cz map integration |
| 44 | +5. **Partners** - Gold/Diamond sponsors and community partners |
| 45 | +6. **Previous Year** - Link to YouTube recordings from 2020 |
| 46 | +7. **Footer** - Social links, contact info, legal documents |
| 47 | + |
| 48 | +### Important Details |
| 49 | +- Conference content is in Czech language |
| 50 | +- Payment integration uses Stripe (buy.stripe.com links) |
| 51 | +- Google Analytics tracking (G-Y8CGC4CB51) |
| 52 | +- Social meta tags configured for Facebook/OG sharing |
| 53 | +- CNAME file points to www.webscience.cz domain |
| 54 | + |
| 55 | +## Development Workflow |
| 56 | + |
| 57 | +### Local Development |
| 58 | +Since this is a static site with no build process, simply open `index.html` in a browser. For testing with external APIs (Mapy.cz) and proper URL routing, use a local web server: |
| 59 | + |
| 60 | +```bash |
| 61 | +python3 -m http.server 8000 |
| 62 | +# or |
| 63 | +npx serve . |
| 64 | +``` |
| 65 | + |
| 66 | +### Deployment |
| 67 | +The site deploys automatically to GitHub Pages when changes are pushed to the `master` branch. The GitHub Action publishes from the `./html` directory (note: this appears to be a configuration issue - the workflow should likely publish from root `.` instead of `./html`). |
| 68 | + |
| 69 | +### Making Changes |
| 70 | + |
| 71 | +**To update conference information:** |
| 72 | +- Edit `index.html` directly for content changes (dates, speakers, schedule, prices) |
| 73 | +- Speaker images go in `img/speaker/` |
| 74 | +- Partner logos go in `img/partners/` |
| 75 | + |
| 76 | +**To update styling:** |
| 77 | +- Edit `style.css` for visual changes |
| 78 | +- Bootstrap classes are available throughout the HTML |
| 79 | +- CSS uses the Fira Code/Fira Mono monospace font family |
| 80 | + |
| 81 | +**To update interactive behavior:** |
| 82 | +- Edit `main.js` for navigation, scroll effects, or menu behavior |
| 83 | +- Keep JavaScript vanilla (no transpilation step) |
| 84 | + |
| 85 | +### Important Notes |
| 86 | +- The deployment workflow references `./html` directory but files are in root - this may need correction |
| 87 | +- CSS is versioned in the HTML (`style.css?v=8`) - increment version when updating styles |
| 88 | +- Ticket prices and Stripe links need manual updates each year |
| 89 | +- Conference date appears in multiple places (meta tags, welcome section, title) - update all instances |
| 90 | + |
| 91 | +## Maintenance Tasks |
| 92 | + |
| 93 | +**Annual conference updates:** |
| 94 | +1. Update conference date in all locations (title, meta tags, welcome section, OG tags) |
| 95 | +2. Update program section with new speakers and talks |
| 96 | +3. Update ticket prices and Stripe payment links |
| 97 | +4. Update partner/sponsor logos and links |
| 98 | +5. Move previous year section to link to new YouTube playlist |
| 99 | +6. Update speaker photos in `img/speaker/` |
| 100 | +7. Increment CSS version parameter if styles changed |
| 101 | + |
| 102 | +**Regular updates:** |
| 103 | +- Monitor and update ticket status (sold-out classes) |
| 104 | +- Add new partners to sponsor sections |
| 105 | +- Update social media links if needed |
0 commit comments