Projects

Create, manage, and revisit every app you've built.

┌──┬──┬──┐ │ │ │ │ ├──┼──┼──┤ │ │ │ │ └──┴──┴──┘

Dashboard loaded List · Grid · Search Synced

Projects

Create, search, and organize projects from your dashboard. Pick up where you left off with full history.

Dashboard

The Projects dashboard is your home base. It shows every project you've created, with at-a-glance information about status, last modified date, and project type.

List and grid views

Switch between two layout modes:

List view — compact rows showing project name, status badge, and last modified date. Best for scanning many projects quickly.
Grid view — card-based layout with a preview thumbnail, project name, and description. Best for visual browsing.

Search

Use the search bar at the top of the dashboard to filter projects by name. Search is instant — results update as you type. You can also search by project description and tags.

Create a project

There are two ways to create a project:

From the dashboard

Tap the + New Project button. This creates an empty project and opens the AI Builder so you can start describing what you want to build.

From the AI Builder

If you're already in a project and want to start fresh, use the New Project option in the header menu. Your current project is saved automatically.

Delete a project

Swipe left on a project in list view (or long-press in grid view) to reveal the delete option. Deleted projects are moved to a trash state for 30 days before permanent removal. There is no undo after permanent deletion.

Project status

Each project has a status that reflects where it is in the development lifecycle:

🟢

Active

The project has been built and is being actively developed. This is the default status after the first successful build.

🟡

Draft

The project was created but no build has been run yet. It's just an empty conversation waiting for a description.

🔵

Archived

The project is complete or no longer being worked on. Archived projects are hidden from the main dashboard by default.

Pull-to-refresh

Pull down on the projects list to force a sync with the server. This fetches any projects created on other devices and updates the local cache. Archon also syncs automatically in the background, but pull-to-refresh gives you control over when it happens.

Empty states

If you have no projects yet, the dashboard shows an empty state with a prompt to create your first project. This includes a brief explanation of what Archon can build and a direct button to open the AI Builder.

How projects connect to AI builds

Every project is a container for:

Conversation history — all messages sent to the AI, preserving full context
Generated files — the complete source code tree
Task timeline — a log of every build step, including successes and failures
Preview state — the last rendered output of the Live Preview

When you open a project, all of this is restored. You can continue the conversation, run new builds, and iterate — the AI has full context from every previous interaction.

// Project data model (simplified)
struct Project {
    let id: UUID
    var name: String
    var description: String
    var status: ProjectStatus  // .active, .draft, .archived
    var createdAt: Date
    var updatedAt: Date
    var conversationHistory: [ChatMessage]
    var generatedFiles: [ProjectFile]
    var tasks: [BuildTask]
}

// Projects are stored server-side (Supabase)
// and cached locally for offline access.