ANDIAMO — ITALY TRAVEL AGENCY TEMPLATE
Updated October 28, 2026 — single-page edition with city guides

START HERE
Open index.html in a modern browser. The template runs locally without a build,
package installation, remote fonts, image hotlinks, or a server backend.
For a local server with Python installed: python -m http.server 8080
Then open http://localhost:8080 in your browser.

ONE PAGE, COMPLETE EXPERIENCE
index.html is the only HTML file in the downloadable package.
Sections: hero and finder, destinations, sample journeys, Italian cuisines and
 dining life, our approach, common questions, and the trip planner.
Navigation uses section anchors: #destinations, #journeys, #cuisine, #approach,
#questions, and #contact. Each region card has an expandable
introduction. Official visitor links open external websites in new tabs.

CITY GUIDES AND OFFICIAL LINKS
When the filters show one sample journey, the card expands across the page.
A detailed guide beside its image covers the featured city: Amalfi, Florence,
Venice, or Como, with dining specialties and linked attractions. On mobile the
guide appears below the image and journey summary. The same dining information
is included in those four city pop-ups. Dining sources are recorded in
DESTINATION-SOURCES.csv alongside the existing visitor-information sources.
The heading Beautiful ways to get away has a destination description to its
right on desktop, with eight direct links to the places' official websites.
This introduction stacks below the heading on smaller screens.
In Beautiful ways to get away, each journey lists two clickable places:
Amalfi and Ravello; Florence and Siena; Venice and Murano; Como and Varenna.
Select a name to open its detailed description and linked places to see.
Explore journey opens both local guides followed by the sample itinerary.
Official tourism, municipal, museum, and attraction links are included within
the descriptions. Some local sources are in Italian, as noted in the copy.
DESTINATION-SOURCES.csv records the publishers, URLs, and review date.
The descriptions are newly written. No images, logos, or verbatim copy from
those websites are included. Links do not imply affiliation or endorsement.
Recheck the links and current visitor arrangements before publication.

CUISINES AND DINING LIFE
The cuisine section displays all fifteen supplied food images in city-linked
galleries: Amalfi/Positano, Florence/Siena, Venice/Murano, and Como/Varenna.
Additional pizza, pastry, and cannoli cards connect to Naples and Palermo.
City navigation jumps to each gallery; journey links select the matching route.
Captions distinguish local specialties from broader Italian-inspired dishes.
The morning coffee, lunch, and evening dining rituals remain included.

EDITING
All shipped HTML is unminified with four-space indentation. Opening tags,
closing tags, and text nodes appear on separate lines. Comments separate HEAD,
BODY, HEADER, MAIN, sections, dialogs, and FOOTER. The footer is inside the body.
Sections are in natural vertical document order. Responsive card grids may
appear side by side on larger screens while the source remains vertical.

styles/italia.css is the only site stylesheet.
scripts/italia.js is the only site script.
Edit the CSS variables near the top of the stylesheet to change the palette.
The body has a data-palette attribute. Nine CSS palettes remain available:
default, blue, dark-blue, gray, green, orange, purple, red, and yellow. Set this
attribute or use index.html?palette=green to preview another palette with JS.
System font stacks are used. No third-party font files or icon libraries ship.

All website content, navigation, and footer markup are in index.html. In the
development workspace, tools/build_theme.py, tools/single_page_sections.py,
and tools/journey_details.py regenerate this HTML. Edit those sources before
rebuilding, or hand edits to
index.html will be overwritten. Development tools are not shipped to buyers.
City copy lives in the city-details-* template elements in the shipped HTML.

FUNCTIONALITY AND DEMO CONTENT
The trip finder updates the journey filters and moves to #journeys without
reloading. Region, duration, and style filters stay in sync with the finder.
The cuisine section can show food journeys or journeys for a selected region.
Buttons open native accessible itinerary dialogs; Escape closes them. The
Make this trip yours link closes the dialog, selects that region in the trip
planner, and moves to #contact without losing other form entries.
The mobile menu has an expanded state and supports Escape to close.
The planner validates required fields, previews a brief, and downloads a TXT.
It does NOT submit an enquiry, contact an agency, make a booking, save personal
data in local storage, or send network requests. Connect your own backend and
add your privacy and business terms before using it for real enquiries.
No fake testimonials, review scores, customer counts, or prices are included.
The brand and all itineraries are illustrative demo content.

IMAGES AND RIGHTS
Twenty user attachments replace all five previous generated travel images.
Five destination/coastal views and fifteen food images are served from
assets/italy-supplied/ as optimized progressive JPEGs with descriptive alt text.
Photos have 640px and 1280px versions; the Positano hero also has an 1800px version.
The favicon is a 64 x 64 PNG. All images in the release are JPEG or PNG.
JPEGs are exported directly from the original attachments at quality 86 with
Lanczos resizing, optimized encoding, sRGB colors, and no EXIF/location metadata.
Responsive srcset lets browsers choose a suitable size; below-the-fold photos
load lazily. The hero loads with high priority. Photo aspect ratios are retained.
IMAGE-SOURCES.json maps assets to source filenames, dimensions, and file sizes.
ASSET-LICENSES.csv records provenance and SHA-256 hashes.
RIGHTS-NOTES.txt documents the supplied-image record and unverified license scope.
Historical generated assets and prompts remain outside the current release.

Rebuild with tools/build_theme.py. The asset mapping and cuisine gallery copy
live in tools/supplied_assets.py. Already converted assets support rebuilding
without access to Downloads; the initial conversion uses the supplied originals.

REPLACING IMAGES
Open assets/italy-supplied/ in the release folder. The filenames describe the
photo: venice.jpg, lake-como.jpg, pizza.jpg, ravioli.jpg, and so on.
Replace both NAME.jpg (1280px wide) and NAME-640.jpg (640px wide) with your new
JPEGs. Positano uses positano.jpg at 1800px, positano-1280.jpg at 1280px, and
positano-640.jpg at 640px. Replace all versions so every device sees the update.
Keep the filenames and existing proportions; IMAGE-SOURCES.json lists exact
dimensions. Use genuine JPEG exports, not renamed PNG/WebP files. Use PNG for
favicon.png and keep it 64 x 64 pixels. Do not enlarge small originals.
Save photos as progressive JPEG, around quality 85–88, with optimized encoding.
The same filename can appear in multiple sections; replacing it updates all uses.
If you change the subject, update the image alt text and captions in index.html.
Refresh the page without its cached images after replacing files.

In the development workspace, a helper can generate all sizes from one original:
python tools/optimize_images.py --source-dir "C:/path/to/replacements" --image venice
The folder can contain venice.jpg, venice.jpeg, or venice.png. Then run:
python tools/build_theme.py
The build preserves existing JPEGs and refreshes dimensions, records, and ZIP.
For new subjects, also update the descriptions in tools/supplied_assets.py.
Development helpers need Python and Pillow; the finished website needs neither.

RELEASE BOUNDARY — IMPORTANT FOR THE ORIGINAL WORKSPACE
Use release/andiamo-italy-template.zip as the clean deliverable, or its sibling
andiamo-italy-template folder. PACKAGE-CONTENTS.txt lists the included files.
Do not sell a ZIP of the entire original workspace. Old Wisdom/Bootstrap files,
images, plugins, fonts, docs assets, and dependency folders remain there for
reference and recovery. They were not licensed or cleared by this task.
Previous versions are backed up under .workspace-backups/. The preceding
multipage release is before-single-page-template.zip. Old generated HTML URLs
in the development workspace redirect to the single-page site. These redirects
and backups are excluded from the clean single-page release.

BEFORE SELLING OR DEPLOYING
Replace the demo brand with a name you are authorized to use. Andiamo was not
subjected to a trademark clearance. Add your chosen end-buyer license terms;
this starter does not invent a sales contract or promise exclusive copyright.
Retain the asset register and applicable image licenses with the template.
Use your own real agency details, verify offered itineraries, and connect your
preferred booking or enquiry provider. Review all final content and behavior.
Read RIGHTS-NOTES.txt: no absolute copyright or non-infringement guarantee is
made. The supplied stock-image redistribution rights have not been verified.

