FAQs & Troubleshooting

Finally, here are some common questions and issues new users might encounter when using the Lunix platform and Lunix Studio, along with answers and solutions:

Q: I entered my OpenAI API key, but the AI Chat says no model is available or isn’t responding. What should I do? A: First, double-check that the key was entered correctly in the Integration Hub (no extra spaces or missing characters). Ensure you hit save and maybe refresh the AI Chat module. If you have a usage quota on OpenAI (or if the key is expired/revoked), that could cause non-response – check your OpenAI account status. You can also try a simple prompt in the API Playground (if available) to test the key. If everything looks correct but it still doesn’t work, it’s possible the OpenAI service is down or the Lunix servers can’t reach it at the moment – wait a bit and try again. Also verify if Lunix Studio expects a specific format (some platforms require “org ID” in addition to key, etc., but usually not for OpenAI). If you have an alternate model like Claude configured, try switching to that to see if the interface works (narrowing down if it’s an OpenAI-specific issue).

Q: The Analyzer failed to analyze a website I put in, or it took too long and timed out. Why? A: There could be a few reasons. The website might be blocking automated agents or requires a login – Lunix’s Analyzer might not get past such restrictions. Or the site could be very large or slow, causing the analysis to time out. As a workaround, you can try using the “Raw HTML” option: visit the site in a browser, copy the page’s HTML source, and paste it into the Analyzer to analyze that snapshot. If the site is single-page application (SPA) that requires running scripts (like a React app), the static HTML might be incomplete; in such cases, you might need to manually save the rendered HTML or use the site’s sitemap to analyze one page at a time. Also, choosing a shallower analysis depth can sometimes succeed where a deep analysis times out. Finally, ensure your internet connection is stable; although Lunix runs in the cloud, your connection dropping could interrupt the analysis results from loading.

Q: I used the Code Generator, but the component doesn’t appear in the Website Builder. How do I use the code I got? A: The Code Generator outputs actual React code meant for development. Lunix’s visual Website Builder doesn’t automatically ingest that code (they operate somewhat separately). To use the code, you have a couple options:

• If you are comfortable with coding: Take the code from the generator and integrate it into your project’s codebase (outside of Lunix Studio). Essentially, Lunix gave you a head start, but you’d use it in a typical React environment.

• If you want it in Lunix’s builder: See if the builder has a “Custom Code” or “Embed Code” component. You might be able to drop your React component code into that. However, note that Lunix Studio’s builder may not execute custom React code – it might be more for embedding HTML/JS snippets (like a widget). Check Lunix documentation on using custom components. Another approach is to manually reconstruct the component in the builder using the visual elements.

• Remember, the Library’s “Generated Components” is basically a storage for code snippets. The Website Builder is a no-code tool. There’s a bit of a gap between them unless explicitly bridged by the platform. Lunix might in the future allow dragging a “library component” into the builder if they implement that, but if not, use the above methods.

Q: The image generated by Image Lab is good, but not perfect. Can I ask the AI to change part of it or make a variation? A: Lunix Studio’s Image Lab likely does single prompts at a time (it’s not a full image editing AI like DALL-E’s inpainting). To iterate, you have a couple of options:

• Refine the prompt and regenerate: For example, if the logo had a weird font for the text, you might refine your prompt to say “without any text” and then add text yourself later, or “with clear, bold lettering”. Or if the colors were off, specify the colors explicitly.

• Generate variations manually: If the underlying AI (like Leonardo) supports a “variation” feature, Lunix might have a button for it (like “generate variations from this image”). If not, slightly tweak your description and run again to get a similar but different output.

• Use Photo Editor: If the changes you need are minor (like brighter or a different crop), open the image in Photo Editor and adjust it there, instead of hoping for the perfect regeneration.

• If you need a very specific edit (e.g., “make the shirt of the person red instead of blue”), Lunix’s tools might not handle that granular change, since that’s more an inpainting task for an AI that supports it. You might need to use an external tool or keep prompting for a new image that matches your need.

Q: Photo Editor won’t upload my image or is acting strangely. Any tips? A: If an image is not uploading, check the format and size. Lunix Photo Editor likely supports common formats like JPEG, PNG (maybe GIF). If you try a huge image (like a 20MB high-res photo), it might struggle. Try resizing the image externally or ensure your internet can handle the upload. If the editor is glitchy (sliders not responding, etc.), it could be a browser issue – save your work and refresh Lunix Studio. Also ensure you’re using a supported browser (Chrome, Firefox, etc., up to date). If you find a certain feature like a filter not working at all, that could be a bug – report it to Lunix support.

Q: I made a page in Website Builder. How do I publish it for others to see? A: Lunix Studio itself might not be a hosting platform (depending on their offerings). Check if there’s a “Publish” option. If there is:

• It might publish to a Lunix-provided staging URL (like myproject.lunix.app or something) which you can share. You’d likely get a link after publishing. This is great for quick sharing.

• If there’s no direct publish, you’ll have to export the page. Use the Library’s “Export to ZIP” which might include the page’s HTML/CSS and any assets. Then you can host these files on any web hosting (GitHub Pages, Netlify, your own server, etc.). If the export is just assets, you might have to manually compose them into an HTML file.

• Another route: If you used the Code Generator heavily, you may already have React code; you can integrate that into a React project and deploy it normally.

• Always test the exported site to ensure everything looks as in the builder. Some interactive elements might need additional scripts; if Lunix uses any (like for a carousel), make sure those files came along in the export.

Q: My API key is correct and was working, but now Lunix Studio features are failing. What happened? A: A previously working key failing could mean:

• You exceeded your usage quota or monthly credit on that service. For instance, OpenAI might have a monthly hard limit or you ran out of pay-as-you-go credit – check your OpenAI account usage. Similarly, image services often have daily limits.

• The API provider changed something (maybe they revoked old keys, or require an account upgrade for continued use).

• The key was accidentally invalidated (e.g., you reset your API keys on the provider side, rendering the old one useless).

• Or simply a temporary outage on the provider side.

• To troubleshoot, try the key directly with the provider’s own docs or playground (if possible) outside Lunix. If it fails there too, it’s not a Lunix issue – it’s the key or account. If it works outside but not in Lunix, maybe re-enter it in Lunix in case something went wrong.

Q: Does Lunix Studio support framework X or library Y? A: Lunix Studio primarily outputs code in React (with Tailwind CSS for styling). If you’re looking to get code for another framework (say Vue or Angular), currently the Code Generator is likely specialized for React (since that was its selling point). However, you could try prompting it for generic HTML/CSS or other frameworks – the underlying AI might still produce something, though it may not be as fine-tuned. The Website Builder produces standard HTML/CSS/JS (framework-agnostic) which you can use anywhere. If you have a very specific library in mind (like “generate a Bootstrap card component”), you could try explicitly mentioning it in the prompt and see if the AI does it. The integrations (like for code) may expand in the future – check release notes for added support. But as of now, if you need a specific tech stack, you might use Lunix for the conceptual and design phase (and perhaps GPT via AI Chat for converting code to another framework manually).

Q: I have a question not answered here or I encountered a bug – where can I get help? A: If this documentation or the built-in help doesn’t cover your issue, you should reach out via Lunix’s support channels. This could be:

• An official Lunix Support Email or Ticket System – usually provided to users for technical support.

• A Community Forum or Discord – where you can ask questions and get answers from other Lunix users or the dev team.

• The GitBook docs online – this guide is a draft, but the official documentation might be updated with more FAQs. Check the Lunix documentation site for a Troubleshooting section.

• When contacting support, be ready to provide details: what module, what you were doing, any error messages, and steps to reproduce the issue. The more info, the easier for them to help you.

We hope this guide has helped you get started with Lunix Platform and Lunix Studio. With its powerful AI integrations and user-friendly tools, you’re now equipped to create websites faster and with creative support at every step. Happy developing!