Achille Press - PaperMod Inspired WordPress Theme

A fast, clean, and responsive WordPress theme inspired by the Hugo PaperMod theme. Built on the Underscores (_s) foundation with modern design principles and enhanced user experience.

✨ Features

Design & Layout

• Clean, minimal design inspired by PaperMod
• Responsive layout that works on all devices
• Light/Dark theme toggle for improved accessibility
• Typography-focused with excellent readability
• Card-based post layouts with hover effects
• Breadcrumb navigation for better UX
• Archive pages with elegant post listings

Navigation & Menus

• Clean header with site title and navigation
• Mobile-responsive menu with hamburger toggle
• Search functionality (if search plugins are available)
• Social media icons in header/footer
• Menu location indicators for active pages

Content Features

• Post meta information (date, author, categories, tags)
• Reading time estimation for posts
• Share buttons for social media
• Related posts suggestions
• Table of contents generation for long posts
• Featured images with responsive support
• Code syntax highlighting support

Performance & SEO

• Optimized CSS with minimal load times
• SEO-friendly markup and structure
• Schema markup for better search results
• Fast loading with optimized assets

🎯 Changes from Original Underscores Theme

Theme Information Updates

1. Theme name: Changed from "_s" to "Achille Press"
2. Theme description: Updated to reflect PaperMod inspiration
3. Author information: Updated theme metadata

Color Scheme & Typography

4. Color palette: Implemented PaperMod-inspired color scheme
   • Light theme: Clean whites and grays
   • Dark theme: Dark backgrounds with light text
   • Accent colors: Subtle blues and greens
5. Typography: Enhanced font stack with better readability
   • Primary font: System fonts for performance
   • Monospace: Improved code font stack
   • Font sizes: Optimized hierarchy
6. CSS Variables: Added for theme switching and consistency

Layout & Structure

7. Header redesign:
   • Cleaner, more minimal header
   • Better navigation placement
   • Added theme toggle button
8. Footer redesign:
   • Simplified footer with social links
   • Copyright and theme attribution
9. Content layout:
   • Wider content area
   • Better spacing and margins
   • Card-based post listings
10. Sidebar handling: Improved responsive sidebar

Navigation Enhancements

11. Menu styling: PaperMod-inspired navigation
12. Mobile menu: Enhanced mobile navigation
13. Breadcrumbs: Added breadcrumb navigation
14. Search integration: Improved search functionality

Post & Page Templates

15. Post meta: Enhanced post metadata display
16. Reading time: Added reading time estimation
17. Share buttons: Social media sharing options
18. Related posts: Post suggestions at end of articles
19. Archive pages: Improved archive and category pages
20. Featured images: Better featured image handling

Components & Widgets

21. Button styles: PaperMod-inspired buttons
22. Form elements: Styled form inputs and fields
23. Code blocks: Enhanced code syntax styling
24. Quote blocks: Improved blockquote styling
25. Widget areas: Updated widget styling

JavaScript Features

26. Theme toggle: Light/dark mode switching
27. Smooth scrolling: Enhanced page navigation
28. Mobile menu: Improved mobile interactions
29. Search enhancement: Better search UX

Performance Optimizations

30. CSS optimization: Minimized and organized styles
31. Font loading: Optimized web font loading
32. Image handling: Responsive image improvements
33. JavaScript: Minimized JS footprint

Accessibility Improvements

34. ARIA labels: Enhanced accessibility markup
35. Keyboard navigation: Improved keyboard support
36. Screen reader: Better screen reader support
37. Color contrast: Improved contrast ratios

WooCommerce Integration

38. Product styling: PaperMod-inspired product layouts
39. Cart/Checkout: Enhanced e-commerce pages
40. Shop styling: Improved shop page design

Additional Features

41. Social icons: Added social media icon support
42. Schema markup: Enhanced SEO markup
43. Custom post types: Better CPT support
44. Language support: RTL and multilingual improvements

🛠️ Installation

Requirements

Achille Press requires the following dependencies:

• Node.js (for SASS compilation)
• Composer (for PHP dependencies)
• WordPress 5.6 or higher
• PHP 7.4 or higher

Quick Start

1. Download or clone this repository to your WordPress themes directory
2. Install dependencies:

   $ composer install
   $ npm install
   

3. Compile the styles:

   $ npm run compile:css
   

4. Activate the theme in WordPress admin

Development Setup

To start developing with all the available tools: $ npm install

### Available CLI commands

Achille Press comes with CLI commands for development:

- `composer lint:wpcs` : checks PHP files against WordPress Coding Standards
- `composer lint:php` : checks PHP files for syntax errors
- `composer make-pot` : generates translation files
- `npm run compile:css` : compiles SASS files to CSS
- `npm run compile:rtl` : generates RTL stylesheet
- `npm run watch` : watches SASS files and recompiles on changes
- `npm run lint:scss` : checks SASS files against CSS standards
- `npm run lint:js` : checks JavaScript files against standards
- `npm run bundle` : creates distribution archive

## 🎨 Customization

### Theme Options
The theme includes several customization options accessible through the WordPress Customizer:

- **Colors**: Light/Dark theme colors
- **Typography**: Font selections and sizes
- **Layout**: Sidebar options and content width
- **Header**: Logo, navigation, and search options
- **Footer**: Social links and copyright text

### Custom CSS
Additional CSS can be added through:
- WordPress Customizer → Additional CSS
- Child theme stylesheet
- Custom CSS plugin

### Social Media Icons
Configure social media links in the Customizer. Supported platforms include:
- Twitter/X
- Facebook
- LinkedIn
- GitHub
- Instagram
- YouTube
- And many more...

## 🌐 Browser Support

- Chrome (latest)
- Firefox (latest)
- Safari (latest)
- Edge (latest)
- Internet Explorer 11+ (limited support)

## 📱 Mobile Responsive

Achille Press is fully responsive and optimized for:
- Desktop computers
- Tablets (portrait and landscape)
- Mobile phones (all sizes)
- High-resolution displays

## 📄 License

This theme is licensed under the GNU General Public License v2 or later.
Use it to create something amazing!

## 🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## 🐛 Bug Reports

If you find any issues, please report them on the GitHub repository.

## 🙏 Credits

- Based on [Underscores](https://underscores.me/) by Automattic
- Inspired by [Hugo PaperMod](https://github.com/adityatelange/hugo-PaperMod) theme
- Icons by [Feather Icons](https://feathericons.com/)

---

**Ready to create something awesome? Let's build a beautiful WordPress site together! 🚀**