> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gridix.live/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating Projects

> Complete guide to creating real estate projects in Gridix - manual setup and import methods

Projects are the foundation of Gridix. Each project represents a real estate development with floor plans, apartments, and pricing. This guide covers both manual creation and import methods.

## Creation Methods Overview

Gridix offers two primary methods for creating projects:

<CardGroup cols={2}>
  <Card title="Import from Excel/Google Sheets" icon="file-spreadsheet">
    Fast and efficient for projects with existing data. Supports Excel files and Google Sheets links with automatic synchronization.
  </Card>

  <Card title="Manual Setup" icon="settings">
    Full control over project structure. Perfect for new developments or when you need complete customization.
  </Card>
</CardGroup>

## Method 1: Import from Excel

Importing from Excel is the fastest way to create a project when you already have data in a spreadsheet.

### Preparing Your Data

Your Excel file should contain the following columns:

| Column           | Description                 | Required | Example                          |
| ---------------- | --------------------------- | -------- | -------------------------------- |
| Apartment Number | Unique apartment identifier | Yes      | 101, 102, A-1                    |
| Floor            | Floor number                | Yes      | 1, 2, 3                          |
| Rooms            | Number of rooms             | Yes      | 1, 2, 3, 4+                      |
| Area             | Area in square meters       | Yes      | 45.5, 68.2                       |
| Price            | Apartment price             | Yes      | 5500000, 7200000                 |
| Status           | Availability status         | Yes      | свободна, продана, забронирована |

<Tip>
  Download the template file from the import dialog to ensure proper formatting. The template includes all required columns with example data.
</Tip>

### Import Process

<Steps>
  <Step title="Open Project Creation">
    In the admin dashboard, navigate to Projects and click "Create New Project".
  </Step>

  <Step title="Select Import Method">
    Choose "Import from Excel" tab. You'll see two options:

    * **Upload File**: Upload Excel file from your computer
    * **Import by Link**: Connect to Google Sheets via link
  </Step>

  <Step title="Upload or Link File">
    **For File Upload:**

    * Click "Upload Excel file"
    * Select your .xlsx, .xls, or .csv file
    * Wait for file processing

    **For Google Sheets:**

    * Click "By link" tab
    * Paste your Google Sheets link (any format)
    * Gridix will automatically convert and sync
  </Step>

  <Step title="Map Columns">
    Gridix auto-detects columns, but you can adjust:

    * Review detected column mappings
    * Match your column names to Gridix fields
    * Verify data types
    * Add custom fields if needed
  </Step>

  <Step title="Configure Floor Layout">
    Answer the floor layout question:

    * **Same layout**: Mark apartments once, apply to all floors
    * **Different layouts**: Configure each floor separately

    <Info>
      If all floors have the same layout, you'll save significant time during setup.
    </Info>
  </Step>

  <Step title="Review Data">
    Review the preview of imported data:

    * Check apartment count
    * Verify data accuracy
    * Review any warnings or errors
  </Step>

  <Step title="Create Project">
    Click "Create Project" to finalize. The project will be created with all apartments and data.
  </Step>
</Steps>

### Benefits of Import by Link

<CardGroup cols={3}>
  <Card title="Always Up-to-Date" icon="refresh">
    Data automatically syncs when your spreadsheet updates. No need to re-upload files.
  </Card>

  <Card title="No Re-upload Needed" icon="upload">
    Changes in Google Sheets are reflected automatically in Gridix.
  </Card>

  <Card title="Real-time Sync" icon="clock">
    Updates happen automatically when data changes in your spreadsheet.
  </Card>
</CardGroup>

## Method 2: Manual Setup

Manual setup gives you complete control over project configuration.

### Starting Manual Creation

<Steps>
  <Step title="Open Project Creation">
    Navigate to Projects → "Create New Project".
  </Step>

  <Step title="Choose Manual Setup">
    Select "Manual Setup" tab and click "Start manual creation".
  </Step>

  <Step title="Enter Basic Information">
    Fill in project details:

    * **Project Name**: Name of your development
    * **Description**: Brief description (optional)
    * **Address**: Physical address
    * **Coordinates**: Latitude and longitude (for map display)
    * **Building Image**: Upload main building image
  </Step>

  <Step title="Configure Building Settings">
    Set building properties:

    * Number of floors
    * Currency (USD, EUR, GEL, RUB, etc.)
    * Project type (building, complex, etc.)
    * Parking availability
    * Commercial space availability
    * Installment calculator settings
  </Step>

  <Step title="Save Basic Info">
    Click "Save" to create the project. You can continue adding details.
  </Step>
</Steps>

### Adding Floor Plans

<Steps>
  <Step title="Navigate to Floor Plans">
    In the project editor, go to the "Floor Plans" section.
  </Step>

  <Step title="Upload Floor Plan">
    For each floor:

    * Click "Upload Floor Plan"
    * Select image file (PNG, JPG, SVG)
    * Recommended size: 1920x1080 or higher
    * Add floor number
  </Step>

  <Step title="Mark Apartments">
    On the uploaded floor plan:

    * Click to mark apartment locations
    * Enter apartment number
    * Set initial properties (rooms, area, price)
  </Step>

  <Step title="Repeat for All Floors">
    Upload and configure floor plans for each floor in the building.
  </Step>
</Steps>

## Project Configuration Options

### Basic Settings

* **Project Name**: Display name for the project
* **Slug**: URL-friendly identifier (auto-generated)
* **Description**: Detailed project description
* **Address**: Full address with city and country
* **Coordinates**: GPS coordinates for map integration

### Building Properties

* **Floors**: Total number of floors
* **Currency**: Pricing currency
* **Project Type**: Building type classification
* **Parking**: Parking availability (yes/no)
* **Commercial**: Commercial space availability
* **Facade View**: Enable 3D facade visualization

### Pricing Settings

* **Default Currency**: Base currency for all prices
* **Installment Calculator**: Enable/disable installment calculations
* **Min Down Payment**: Minimum down payment percentage
* **Max Installment Months**: Maximum installment period

## After Project Creation

<Check>
  Once your project is created, you can:

  * Edit project details
  * Add or modify apartments
  * Upload additional floor plans
  * Configure custom fields
  * Set up visualization settings
  * Generate widget code
  * Connect CRM integrations
</Check>

## Supported File Formats

### Excel Import

* **Excel**: .xlsx, .xls
* **CSV**: .csv
* **Google Sheets**: Any shareable link format

### Floor Plan Images

* **PNG**: Recommended for detailed floor plans
* **JPG**: Good for photographs
* **SVG**: Vector format for scalability

## Troubleshooting

<AccordionGroup>
  <Accordion title="Import fails">
    * Check file format (Excel, CSV supported)
    * Verify required columns are present
    * Ensure data is in correct format
    * Check file size (max 10MB)
    * Try downloading template and using it
  </Accordion>

  <Accordion title="Columns not detected">
    * Ensure first row contains headers
    * Check column names match expected names
    * Manually map columns if needed
    * Use template file for reference
  </Accordion>

  <Accordion title="Floor plan not uploading">
    * Check file format (PNG, JPG, SVG)
    * Verify file size (max 5MB per image)
    * Ensure image is not corrupted
    * Try different image format
  </Accordion>
</AccordionGroup>

## Best Practices

<Tip>
  **Use templates**: Always start with the provided template to ensure proper formatting and avoid errors.
</Tip>

<Tip>
  **Regular backups**: Export your project data regularly for backup purposes.
</Tip>

<Tip>
  **Consistent naming**: Use consistent naming conventions for apartments (e.g., 101, 102, 201, 202).
</Tip>

<Tip>
  **High-quality images**: Use high-resolution floor plan images for better visualization.
</Tip>

## Next Steps

* **[Editing Projects](/en/projects/editing)** - Learn how to edit and customize your project
* **[Apartment Management](/en/projects/apartments)** - Configure apartments and properties
* **[Visualization Setup](/en/projects/visualization)** - Customize floor plan display
* **[Pricing Configuration](/en/projects/pricing)** - Set up pricing and installment calculator