How do I manage my project settings in Macaly?

The Settings section brings together all the core configuration options for your project in Macaly. From here, you can manage your project name, sharing settings, domains, secrets, and other important project settings.

To access Settings:

1. Open your project.
2. Click Settings in the tab bar at the top of the chat.

Settings Sections

The Settings area includes three main tabs:

• General
• Domains
• Secrets

---

General

The General tab contains your project's key information and management options.

• Name: The Name field displays your project's name.
  To rename your project:
  1. Click the pencil icon.
  2. Enter the new name.
  3. Save the change.

• Created: Displays the date the project was created. This information is view-only and cannot be modified.

• AI Model: The AI Model setting determines which artificial intelligence model the Agent uses to build and edit your project.
  In general:
  • More powerful models produce better results.
  • More powerful models consume more credits.

• Sharing: The Sharing setting controls who can access your project.
  Available options:
  • Only workspace members: The project remains private and is accessible only to members of your workspace.
  • Anyone with link: Anyone who has the project link can access it. This setting works similarly to the Share button in the toolbar.

• Download Source Code: The Download Source Code option allows you to download your project's complete source code as a ZIP file.
  This is useful when you want to:
  • Keep a backup copy of the project.
  • Edit the code outside of Macaly.
  • Move the project to a different development environment.

• Embed: The Embed option generates an iframe snippet that can be embedded into another website. This allows you to display your published project within an external website.

• Publish: The Publish section displays your project's current publishing status and provides quick access to publishing options.
  From here, you can:
  • Check whether the project is published.
  • Access the publishing workflow.

---

Domains

The Domains tab is used to connect a custom domain to your project.

Every published project automatically receives a free Macaly subdomain.

Example

myproject.macaly.app

If you already own a domain, you can connect it through the same section.

Connecting a Custom Domain

1. Go to Settings → Domains.
2. Enter your domain name.
3. Click Connect.
4. Follow the instructions displayed on screen.

For more information about domain connections and DNS records, refer to the Domains & Hosting guide.

---

Secrets

The Secrets tab is used for securely storing sensitive information required by your project.

Examples include:

• API keys
• Access tokens
• Credentials for external services

These values are encrypted and are never exposed in your project's code or previews.

Creating a Secret

To add a new Secret:

1. Go to Settings → Secrets.
2. Click Add Secret.
3. Enter:
   • The Secret name
   • The Secret value
4. Save the entry.

Naming Rules

Secret names may only contain:

• Uppercase letters (A-Z)
• Numbers (0-9)
• Underscores (_)

Valid Example: STRIPE_API_KEY

Invalid Examples: stripeKey, Stripe-API-Key, my secret

Secret Duplication

When you duplicate one of your own projects, Secrets are copied automatically.

However, when duplicating a:

• Shared project
• Template

Secrets are not copied for security reasons.

---

Helpful Tips

• Use clear and descriptive names for your projects.
• Store sensitive keys only within the Secrets section.
• Review sharing settings before sharing a project with others.
• Use a custom domain for a more professional online presence.
• Download the source code whenever you need a backup or want to work locally.