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

# Getting Started

> Get your Pageo profile up and running in minutes

## Introduction

### What is Pageo?

Pageo is the simplest way to share all your links in one place. It's a minimal, fast, and developer-friendly link-in-bio platform that gets out of your way.

Instead of wrestling with complex builders or overwhelming dashboards, Pageo gives you a clean interface to share your social links, projects, and anything else—all in under a minute.

### Why Pageo?

We built Pageo because we were frustrated with existing link-sharing platforms. They were either:

* **Too bloated**: Packed with features we'd never use
* **Too slow**: Hours of setup just to share a few links
* **Too complicated**: Complex builders that got in the way

Pageo is different. We believe the best tools are the ones you barely notice—they just work.

### Core Philosophy

Every decision we make is guided by one principle: **less is more, and speed matters**.

We strip away everything that doesn't serve the core purpose—helping you share your links instantly. The result? A platform that feels effortless to use and delightful to experience.

## Features

### Multiple Layouts

Choose between list and grid views. Customize how your links appear to visitors without the complexity.

### Analytics

Track page views, link clicks, and visitor insights. Know what resonates with your audience.

### GitHub Sync

Manage your profile via a JSON file in your repository. Version control your identity, sync automatically, and manage everything as code.

### Custom Domains

Use your own domain for a professional presence with full ownership.

### Contact Form

Built-in contact form with email notifications. No third-party services needed.

### Instant Setup

Go live in under a minute. No complicated onboarding or setup wizards—just pure speed.

## Quickstart

Get your Pageo profile up and running in three simple steps.

### Step 1: Create Your Account

1. Go to [pageo.me](https://pageo.me)
2. Click **Sign Up** or **Login**
3. Sign up with your email or use GitHub OAuth
4. Verify your email if required

### Step 2: Claim Your Username

1. After signing up, you'll be prompted to choose a username
2. Pick a unique handle (e.g., `johndoe`)
3. Your profile will be available at `pageo.me/johndoe`
4. Usernames are limited to 30 characters and must be unique

<Note>
  Your username becomes your profile URL (e.g., `pageo.me/yourusername`). You
  can change it later from the sidebar by clicking on your @username.
</Note>

### Step 3: Add Your Links

1. Go to your admin dashboard
2. Add your profile information:
   * Name
   * Role/Title
   * Bio
   * Profile image (optional)
3. Add social links:
   * Click "Add Social Link"
   * Enter the URL (e.g., `https://github.com/username`)
   * Pageo automatically detects the platform
   * Add up to 8 social links
4. Add grid links (optional):
   * Click "Add Grid Link"
   * Add title, description, image, and URL
   * Add up to 4 grid links
5. Choose your layout:
   * **List**: Vertical list of links
   * **Grid**: Grid of link cards
6. Configure settings:
   * Enable/disable contact form
   * Customize your profile appearance

### Step 4: Publish Your Profile

1. Review your profile in the preview
2. Click **Publish** when you're ready
3. Your profile is now live at `pageo.me/yourusername`
4. Share your link everywhere—social media, email signatures, business cards

## Your First Profile

### Basic Profile Setup

Your profile consists of:

* **Profile Information**: Name, role, bio, and profile image
* **Social Links**: Links to your social media profiles (Twitter, GitHub, LinkedIn, etc.)
* **Grid Links**: Featured projects, articles, or any links you want to highlight
* **Settings**: Layout preference and contact form toggle

### Adding Social Links

1. In your admin dashboard, find the "Social Links" section
2. Click "Add Social Link"
3. Paste your social media URL
4. Pageo automatically:
   * Detects the platform (GitHub, Twitter, LinkedIn, etc.)
   * Adds the appropriate icon
   * Validates the URL
5. Drag to reorder links
6. Click the trash icon to remove a link

**Supported Platforms**: GitHub, Twitter/X, LinkedIn, Instagram, YouTube, TikTok, and many more.

### Adding Grid Links

Grid links are perfect for showcasing projects, articles, or featured content:

1. Click "Add Grid Link"
2. Fill in:
   * **Title**: Name of your project/content
   * **Description**: Brief description
   * **Image**: URL to an image (or upload)
   * **URL**: Link to your project/content
3. Choose layout: "grid" or "list"
4. Add up to 4 grid links

### Layout Options

**List Layout**:

* Clean, vertical list of links
* Perfect for simple link sharing
* Minimal and fast

**Grid Layout**:

* Visual grid of link cards
* Great for showcasing projects
* More visual and engaging

You can switch between layouts anytime in your settings.

### Profile Customization

#### Profile Image

* Upload an image (max 2MB)
* Supported formats: JPG, PNG, WebP
* Image is automatically optimized
* You can crop the image after uploading

#### Bio

* Write a brief bio about yourself
* Supports Markdown formatting
* Keep it concise and engaging

#### Contact Form

* Enable the contact form to let visitors reach out
* All messages are sent to your account email
* View and manage messages in your admin dashboard

## Managing Your Profile

### Editing Your Profile

1. Go to your admin dashboard
2. Make changes to any section
3. Changes are saved automatically
4. Preview your profile before publishing

### Reordering Links

* **Social Links**: Drag and drop to reorder
* **Grid Links**: Drag and drop to reorder
* Changes are saved automatically

### Analytics

View your profile analytics:

* **Page Views**: Total visits to your profile
* **Link Clicks**: Clicks on individual links
* **Visitor Insights**: Geographic and device data

Access analytics from your admin dashboard.

### Publishing and Unpublishing

* **Publish**: Make your profile publicly accessible
* **Unpublish**: Hide your profile (only you can access it)
* You can toggle publishing anytime

## Next Steps

Now that you have a basic profile set up, explore these advanced features:

* **[GitHub Integration](/integrations/github)**: Manage your profile as code with automatic syncing
* **Custom Domains**: Connect your own domain (coming soon)
* **Advanced Analytics**: Detailed insights into your profile performance

## Tips for Success

1. **Keep it simple**: Don't overwhelm visitors with too many links
2. **Use quality images**: Good images make your profile stand out
3. **Update regularly**: Keep your links and projects current
4. **Test your links**: Make sure all links work before publishing
5. **Optimize your bio**: A clear, engaging bio helps visitors understand who you are

## Getting Help

* Check the [GitHub Integration guide](/integrations/github) for code-based management
* Visit our [changelog](https://pageo.me/changelog) for latest updates
* Contact support if you need assistance

## Common Questions

### How many links can I add?

* **Social Links**: Up to 8
* **Grid Links**: Up to 4

### Can I change my username?

Yes! You can change your username anytime. Go to the sidebar in your admin dashboard and click on your @username to update it.

### Is my profile public?

Your profile is only public if you click "Publish". Unpublished profiles are only accessible to you.

### Can I use a custom domain?

Custom domain support is coming soon. For now, your profile is available at `pageo.me/yourusername`.

### How do I delete my account?

Contact support to delete your account and all associated data.