Getting Started with Floyi

This guide walks you through your first session in Floyi, from creating a project to generating your first brief and draft. It is designed for new users who want a clear path, not a full feature tour.

It follows the exact in-app flow: project → Brand Foundation → personas → Topical Research → SERP Clustering → Topical Map → Topical Authority → Planner → briefs and drafts.

If you want a detailed breakdown of every module, see the Floyi Tools Overview.

In this guide you will:

1. Create your first project.
2. Set up Brand Foundation and personas.
3. Run Topical Research for a core theme.
4. Start SERP Clustering directly from the research outline (no exports).
5. Build a Topical Map from clustering results.
6. Run a Topical Authority compute.
7. Prioritize topics in the Planner.
8. Generate your first brief and draft.

You can do all of this with a single site or brand.

1. Sign in to Floyi.
2. Create a new project and name it after your brand or main domain.
3. Choose the primary country and language for your audience.

A project keeps Brand Foundation, personas, research, clustering, maps, briefs, and drafts together. One project per brand/domain keeps everything clean.

If you work with multiple brands or domains, create one project per brand.

Next, give Floyi the context it needs so every workflow uses the same strategy.

1. Open Brand Foundation in your project.
2. Add brand name, domain, and a short description.
3. Fill in: what you sell, who you help, value pillars/differentiators, and key competitors.
4. Save it; you can refine tone and positioning later.

You can keep this light for your first run, then come back later to refine voice, positioning and detailed notes.

See: Brand Foundation

Now define who you are writing for.

1. Open Audience Insights.
2. Use your Brand Foundation as context when prompted.
3. Start with one primary persona such as:
   • Your main buyer
   • Your main user
   • A key influencer or champion
4. Generate the persona, then skim and edit:
   • Role and responsibilities
   • Pains and triggers
   • Goals and success criteria
5. Repeat for one or two more personas if needed.

You can always return to add, refine or delete personas, but having at least one solid persona will help all later steps.

See: Audience Insights

With brand and audience in place, you can start building your topic strategy.

1. Open Topical Research.
2. Choose a core theme that is central to your product, for example:
   • “Email deliverability for SaaS”
   • “B2B payment processing”
3. Select:
   • Brand Foundation profile
   • One primary persona
4. Run the research to generate main topics and subtopics.
5. Review the outline:
   • Rename any topics that feel off
   • Remove items that are clearly out of scope
   • Add any obvious missing topics at the right level

You now have a structured outline tailored to your brand and audience, not a generic keyword dump.

See: Topical Research

Next, connect your topics to real search behavior.

1. From Topical Research, head directly to SERP Clustering.
2. Confirm your country, language, and SERP similarity percentage.
3. Run clustering to fetch SERPs and group related queries.
4. Review the clusters:
   • Check if the centroid keyword matches the main intent
   • Merge or split clusters only where it is clearly needed
   • Note any clusters that look like “supporting content” rather than main pages

You can re-cluster for free using the same SERPs, so do not overthink it on the first pass.

See: SERP Clustering

Now you can turn clusters into a navigable map.

1. In Clustering, click Start Topical Hierarchy when clusters look right.
2. The map is generated from your clustering data; you land in Topical Map & Content Plan.
3. Clean the hierarchy: pillars at the top, clusters under the right pillar, remove noise.
4. Add or adjust URL slugs for page-level topics you plan to publish.

Your Topical Map is now a source of truth for how your site should be structured around this theme.

See: Topical Map

If your site already has content, you can see where you stand today.

1. In Topical Map, click Next: Topical Authority.
2. Fix any validation issues (structure, required slugs) if prompted.
3. Start the Topical Authority compute to fetch rankings and AI Overviews for the map.
4. Once it completes, review:
   • Coverage across the map
   • Visibility and Share of Voice
   • Which pillars and topics are currently weak or empty

If your site is new and has little or no content, you can skip this step now and return after you have published a few pieces.

See: Topical Authority Scorecard

Now turn insight into a simple publishing queue.

1. Open Topical Authority Planner.
2. Use filters such as Not published, Not in SERP, or weak pillars.
3. Pick 3–5 topics for your first batch.
4. Confirm URL slugs, check suggested internal links/anchors, and add team notes.
5. Use the Published toggle to reflect current status where applicable.
   You now have a small, focused list of topics that matter to authority, not just isolated keywords.

See: Topical Authority Planner

Finish the loop by creating content from the plan.

1. In the Planner, pick one of your selected topics.
2. Open the topic drawer and generate a Content Brief:
   • Include your Brand Foundation and main persona
   • Pull in relevant internal links and anchors
   • Review SERP insights and competitors
3. Once the brief looks right, open it in the Content Creation workspace.
4. Use the AI Writer to generate a first draft.
5. Edit the draft:
   • Correct details and add real examples
   • Tighten headings and structure
   • Align tone with your brand

When you are happy, mark the content as ready to publish in your own CMS, then update its status in Floyi.

See:

• Content Briefs
• Content Creation

After you have completed this first loop:

• Repeat the workflow for additional pillars or themes
• Refine Brand Foundation and personas with real feedback
• Continue building briefs and drafts for your Topical Map to cover more of your product and customer journey
• Use Scorecard and Planner on a schedule to keep authority on track

From here, the individual module docs go deeper into advanced options, settings and edge cases. When you feel comfortable with this basic loop, the Floyi Tools Overview is the best place to explore everything else that is available.