Skip to content
Astro Swiss Theme

Support & FAQ

Get support for your Astro Swiss Theme and find answers to common questions.

Getting Help

Section titled “Getting Help”

Thank you for using the Astro Swiss Starter Theme!

Check Documentation First

Section titled “Check Documentation First”

The documentation is designed to answer every setup, customization, and deployment question:

Contact Us

Section titled “Contact Us”

The theme is self-serve by design — the documentation and the FAQ below are the primary way to solve issues. For purchase, download, or refund questions, or to report a bug:

Email: hello@astroswiss.com

Frequently Asked Questions

Section titled “Frequently Asked Questions”

Installation & Setup

Section titled “Installation & Setup”

Q: What are the system requirements?

A: You need Node.js 22.12+ and npm. See Getting Started for details.

Q: How do I install the theme?

A: Extract the zip file, run npm install, then npm run dev. Full instructions in Getting Started.

Q: The build fails with errors. What should I do?

A: Make sure you’re using Node.js 22.12 or higher. Delete node_modules and package-lock.json, then run npm install again.

Customization

Section titled “Customization”

Q: How do I change the colors?

A: Edit src/styles/tokens.css to change the color scheme. See Styling Guide.

Q: How do I add my logo?

A: Replace src/assets/logo.svg with your logo. See Customization Guide.

Q: Can I add more languages?

A: Yes! Follow the Adding Languages Guide.

Q: How do I change the company information?

A: Edit src/consts.ts to update company details. See Data Management.

Content Management

Section titled “Content Management”

Q: How do I add portfolio projects?

A: Add projects to src/data/portfolio/fr.ts and de.ts. See Data Management.

Q: How do I add team members?

A: Add employees to src/consts.ts. See Data Management.

Q: How do I change the services?

A: Edit translations in src/i18n/ui.ts. See Data Management.

Deployment

Section titled “Deployment”

Q: How do I deploy my site?

A: We recommend Netlify or Vercel. See Deployment Guide for step-by-step instructions.

Q: My site works locally but not in production. Why?

A: Check that your build completed successfully and that environment variables are set correctly.

Q: How do I set up a custom domain?

A: This depends on your hosting provider. See Deployment Guide for provider-specific instructions.

Features

Section titled “Features”

Q: Does the contact form actually send emails?

A: This form is a frontend-only template. It formats the email content using the href="mailto:" attribute but does not send emails itself. To actually submit and process form data, you must connect it to a backend service such as Formspree, Netlify Forms, or your own API.

Q: How do I add Google Analytics?

A: Add your Google Tag Manager ID (PUBLIC_GTM_ID) to .env. See the Analytics Guide.

Q: Is the theme SEO-friendly?

A: Yes! It includes automatic sitemap generation, meta tags, and semantic HTML. See the Deployment Guide.

Technical Issues

Section titled “Technical Issues”

Q: Dark mode doesn’t persist after page reload.

A: This is usually a browser localStorage issue. Check your browser’s privacy settings.

Q: Images aren’t loading.

A: Make sure images are in src/assets/ and imported correctly. Astro optimizes images at build time.

Q: The language switcher doesn’t work.

A: Check that you have translations for all languages in src/i18n/ui.ts.

Community Resources

Section titled “Community Resources”

Astro Resources

Section titled “Astro Resources”

Starwind Resources

Section titled “Starwind Resources”

Tailwind Resources

Section titled “Tailwind Resources”

Feedback & Feature Requests

Section titled “Feedback & Feature Requests”

We love hearing from our users! If you have:

  • Feature Requests - Ideas for new features
  • Feedback - Suggestions for improvements
  • Bug Reports - Issues you’ve encountered

Please email us at: hello@astroswiss.com

GitHub

Section titled “GitHub”