💲 astro-marketing-theme
Astro marketing theme. Sidebar nav, services, contact, about, projects, blog aggregator, with a financial business as placeholder.
⚡ Theme Highlights
🗂️ Sidebar Layout — Persistent nav sidebar with nested dropdowns, social links, quick-access external sites
📄 Pages — Home, About, Blog, Services (sub-pages), Portfolio, Contact, Privacy, Terms, 404
📡 Blog Importer — Fetches external RSS feed + sitemap at build time. No CMS, no client-side requests
✉️ Quick Contact — Two-step topic-selector form via Web3Forms. No backend
💬 Chat Widget — Simulated live-chat on homepage. Fully static, zero third-party scripts
🖼️ Featured Slider — Auto-populated hero image carousel from projects.json entries
📦 Asset Downloader — Fetches icons and static files from CDNs before every build. Browser never hits a CDN
🪆 GitHub Images — Pulls first README image per project repo at build time. Cached in github-image-cache.json
🌗 Dark / Light Mode — Defaults dark. User toggle saved to localStorage
🚀 Quick Start
Docker
docker compose build && docker compose up
🎯 Perfect For
- Freelancers and agencies who need a great base theme for service based induestries
- Small firms needing a full site — services, portfolio, blog, contact — without a CMS or backend
- IT firms, dev shops, and contractors who want GitHub repos surfaced automatically on a portfolio page
- Any professional services business — construction, finance, legal, creative — that needs services, portfolio, blog, and contact
🌐 Deployment Made Easy
CI/CD workflows are already included in the repo. Just push your code, set your environment variables, and let the platform do the rest.
- GitHub Pages (Auto-detects base paths & custom domains)
- GitLab Pages (Auto-detects CI_PAGES_URL)
- Gitea / Forgejo / Codeberg (Build artifacts + Codeberg Pages support)
- Self-Hosted / VPS (Docker outputs a lean ~25MB Nginx image)
✏️ Writing Blog Posts
src/content/posts/ contains the markdown files that will become your blog posts:
- The markdown files in this folder will be rendered as blog posts during build time
- These markdown files require frontmatter added to them, as a metadata for the website
🗺️ Content Files
All content lives in src/data/. No code changes needed to customize any section.
global/site.json — Site name, legal name, URL, contact email, Web3Forms key, service types
global/personal.json — Team/contact info, LinkedIn, social links, about bio
global/navigation.json — Sidebar nav items (nested), footer links, social label, other-sites list
home/hero.json — Hero eyebrow, heading, blurb, CTA buttons
home/transaction-desk.json — Chat widget copy, deal pipeline stats, sector list
home/portal.json — Client portal card and quick stats
services/services.json — Service cards (slug, title, highlights, theme colors, page meta, capabilities)
services/services-index.json — Services index page intro copy
projects/projects.json — Portfolio company cards (title, category, tags, images, GitHub repo)
projects/projects-page.json — Projects page intro copy
projects/testimonials.json — Testimonial entries on the projects page
about/about.json — About page paragraphs, contact bar, pillar cards
contact/contact.json — Full contact page copy and form labels
contact/quickhelp.json — Quick Contact widget — topic list, form labels, success messages
contact/contact-ctas.json — Contact CTA cards shown across the site
