Pagesmith
Start building

Quick Start Guide

Create a Pagesmith project, review the generated website, make changes, and publish it.

This guide covers the main workflow: create a project, review the generated site, make changes, and publish it.

Step 1: Create Your Account

  1. Go to pagesmith.ai and click Get Started
  2. Sign up with email or Google
  3. You’ll land on your dashboard

Plan limits can change. Check the current pricing page for free and paid plan details.

Step 2: Start a New Project

From your dashboard:

  1. Click Create New Project
  2. Describe what you want to build:
A landing page for a productivity app called FocusFlow.
Clean, modern design with a hero section, features grid,
pricing table, and contact form.
  1. Click Generate and wait for the first draft

The AI creates an Astro project that can include:

  • All pages and components
  • Responsive design
  • SEO meta tags
  • Proper HTML structure

Step 3: Preview Your Site

Once generated, you’ll see:

  • Live preview in the center panel
  • AI chat on the left for changes
  • File browser for code access

Toggle between desktop, tablet, and mobile views to check responsiveness.

Step 4: Refine with AI

Make changes by describing what you want:

Add content:

Add a testimonials section with 3 customer quotes between
the features and pricing sections.

Modify design:

Change the hero background to a subtle gradient from
blue-600 to indigo-700. Make the headline larger.

Update text:

Change the main headline to "Stay Focused, Ship More"
and update the subheadline to describe time-blocking features.

The preview updates after the change is applied. Review the affected page at desktop and mobile sizes.

Step 5: Publish Your Site

When you’re ready to go live:

  1. Click the Publish button
  2. Pagesmith builds and deploys the current version
  3. Get a live URL like your-project-site.pagesmith.app

Build and deployment time depends on the project. Each publish creates a version you can restore later.

Step 6: Add a Custom Domain (Optional)

To use your own domain:

  1. Go to Settings → Domains
  2. Enter your domain (e.g., focusflow.com)
  3. Add the DNS records shown
  4. Wait for DNS and SSL setup to complete

See Custom Domains for detailed setup.

What’s Next

Your site is live. Here’s what to explore:

Edit Further

Add Features

Learn More

  • Key Concepts: Understand static generation, server rendering, and Astro
  • Use Cases: Follow a guide for a specific project
  • Tips: Check SEO, performance, and design guidance

Common First Questions

Can I edit the code directly?

Yes. Click the Code tab to see and edit all files. Changes sync with the visual preview.

How do I add a new page?

Ask the AI: “Add a new About page with team bios and company history.” Or create a new file in src/pages/.

Can I export my site?

Code export is available on eligible plans. Follow the Export guide and test the project before moving it to another host.

What if I break something?

Use History to restore an available earlier version. Check that the restored preview contains the content you expect before publishing it.