# Project

## 📦 Projects in Digia

A **Project** in Digia represents a complete mobile application configuration that can be visually designed, tested, and managed—all without writing code. Projects serve as the central unit for organizing screens, components, logic, and integrations within the Digia Studio.

***

### 1. 🔍 What is a Project?

A project in Digia defines the structure, behavior, and styling of your mobile app. It includes:

* Pages and widgets
* Navigation rules
* Functions and API calls
* Design tokens and themes
* Build and test settings

Each project is isolated, version-controlled, and can be independently previewed, exported, or integrated with GitHub.

***

### 2. ➕ Creating a New Project

To create a new project:

1. Click **New Project** from the dashboard.
2. Enter a **project name**.
3. (Optional) Upload a **thumbnail** to visually identify your project.
4. Click **Create**.

The project will be initialized with a default page.

***

### 3. ✨ Start from Scratch vs Template

When creating a project, you will soon be able to choose between:

* **Start from Scratch**: Build your app page by page.
* **Start from Template** *(coming soon)*: Use a pre-designed app structure to speed up development.

***

### 4. 🧪 Running & Testing a Project

You can test your app instantly using:

* **Preview Mode**: Launch a real-time, interactive preview within the Digia Studio.
* [**Preview App**](https://docs.digia.tech/quick-start-and-setup/setup#previewing-your-app)**:** Download Digia Preview app from Playstore and Appstore and login test your project on a physical device.
* [**SDK Integration**](https://docs.digia.tech/studio-workspace/broken-reference): Integrate Digia's SDK in your existing app and run your project.

***

### 5. 🤝 Collaborate on Projects

{% hint style="warning" %}
Only Admins and Maintainers can Release projects
{% endhint %}

{% hint style="success" %}
Collaboration is only Available on Teams plan
{% endhint %}

Collaborate seamlessly with your team:

* Invite members from the **Members** section in the Navigation Menu.
* Share access to preview, edit, and manage the app together.
* Changes are auto-synced and versioned.

***

### 7. 🕒 Versioning

Versions are like Git tags. Digia automatically saves every change but you can also:

* **Create named versions** before major updates.
* **Revert** to any previous version with one click.

Use versioning to safeguard your work and create snapshots of your work.

***

### 8. 🚀 Release Management

{% hint style="warning" %}
Only Admins and Maintainers can Release projects
{% endhint %}

When you're ready to publish:

* Use the **“Create Release”** button to package the current configuration.
* Releases are **read-only snapshots** that can be shared, tested, or exported.
* Digia enforces **release limits** based on your plan (e.g. one active release in the Free Plan).

***

> 💡 Pro Tip: Regularly create versions before big edits and release only tested versions to ensure app stability.

### 9. ⚙️ Project Settings

Access the **Project Settings** from the Navigation Menu to:

* Change the **Project Name**
* Edit the **Package Name** used during build and export
* View project metadata and configurations

***

#### 🔗 Related Documentation

* [Finding Page/Component Slugs](https://docs.digia.tech/studio-workspace/builder-tool/finding-slugs) - How to locate and copy page/component slugs within your project
* [Pages](https://docs.digia.tech/ui-building-blocks/pages) - Creating and managing pages in your project
* [Previewing Your App](https://docs.digia.tech/quick-start-and-setup/setup#previewing-your-app) - Testing your project during development