Development Reference
Prompts for building out remaining SOCAL Maico features
Build out the parts list landing pages for all remaining years (1975, 1976, 1977, 1978, 1979, 1980, 1982, 1983) engine, frame, and chassis — scrape each from the Wayback Machine. For each page: - Fetch the HTML from https://web.archive.org/web/[timestamp]/https://www.oldsocalmaico.com/partslists/[YY][type].html - Parse the table data (Picture No., Part No., Description, MC 250, MC 400, MC 490) - Create a TypeScript data file at src/data/parts/[year]-[type].ts - Create a page at src/pages/parts/[year]/[type].tsx using the PartsListPage component - Include the exploded diagram image from the Wayback Machine archive - Register the route in src/routes.tsx
Build the 1981 frame and chassis parts list pages using the same data-driven system as the 1981 engine page. Steps: 1. Scrape https://web.archive.org/web/[timestamp]/https://www.oldsocalmaico.com/partslists/81frame.html 2. Scrape https://web.archive.org/web/[timestamp]/https://www.oldsocalmaico.com/partslists/81chassis.html 3. Parse all table rows (Picture No., Part No., Description, MC 250, MC 400, MC 490) 4. Create src/data/parts/1981-frame.ts and src/data/parts/1981-chassis.ts 5. Update src/pages/parts/1981/frame.tsx and src/pages/parts/1981/chassis.tsx to use PartsListPage component with real data 6. Include the exploded diagram images from the Wayback archive
Add the Maico Service Handbook PDF download button to the homepage hero section. Steps: 1. Search the Wayback Machine CDX API for any archived PDFs on socalmaico.com: https://web.archive.org/cdx/search/cdx?url=socalmaico.com/*.pdf&output=json 2. Download any found PDFs and save to /shared-storage/public/assets/pdfs/ 3. Add a download button in the hero section of src/pages/index.tsx: - Label: "Download Service Handbook (PDF)" - Style: dark button with yellow border, IBM Plex Mono font - Link to /airo-assets/uploads/pdfs/[filename] 4. If no PDF found in archive, add a placeholder button that links to mailto:[email protected] with subject "Service Handbook Request"
Build the Project Bikes / Used Parts page with listings pulled from the archived site. Steps: 1. Scrape https://web.archive.org/web/[timestamp]/https://socalmaico.godaddysites.com/shop?olsPage=t%2Fused-parts&page=2 2. Extract any product listings, titles, prices, and descriptions 3. Update src/pages/used-parts.tsx with real listing data 4. Add a grid of listing cards with: title, price, condition, description, "Contact to Buy" CTA 5. Each card links to mailto:[email protected] with the item name pre-filled in subject 6. Add pagination if more than 8 listings
Search the Wayback Machine CDX API for any archived PDFs from socalmaico.com. Steps: 1. Query: https://web.archive.org/cdx/search/cdx?url=socalmaico.com/*.pdf&output=json&limit=100 2. Also query: https://web.archive.org/cdx/search/cdx?url=socalmaico.com/partslists/*.pdf&output=json 3. For each found PDF, download it: curl -L "https://web.archive.org/web/[timestamp]/[original_url]" -o /shared-storage/public/assets/pdfs/[filename] 4. Create a PDF resources page at src/pages/resources.tsx listing all found PDFs 5. Add download buttons for each PDF 6. Link the resources page from the homepage and navigation
Add a "Service Handbook" or "Downloads" link to the main navigation in src/layouts/parts/Header.tsx. - Add between "Master Parts List" and "Contact" - Links to /resources or directly to the PDF download - Style consistent with existing nav links
Improve SEO across all SOCAL Maico pages. For each page: 1. Add JSON-LD structured data (Organization schema on homepage, BreadcrumbList on parts pages) 2. Ensure all Helmet title/description/og tags are unique and descriptive 3. Add canonical URLs 4. Register all routes in src/lib/seo-routes.ts for sitemap generation 5. Add alt text to all images 6. Ensure heading hierarchy is correct (one H1 per page)
Build a global part number search feature that searches across all available parts lists. Steps: 1. Create a combined search index from all available parts data files in src/data/parts/ 2. Build a search page at src/pages/parts/search.tsx 3. Add a search input to the homepage parts diagrams section 4. Results show: part number, description, which year(s) it appears in, and MC model compatibility 5. Link each result to the relevant parts list page with the search term pre-filled