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

# Query tips

> Write Reposeek queries that return stronger repo candidates.

# Query tips

Good Reposeek queries describe the repo you want to build on, not the code you want Reposeek to write.

## Good query shape

Include the product category, stack, and constraints when they matter:

```text theme={null}
nextjs saas starter stripe api keys
self-hosted calendly alternative
local AI assistant that remembers screen activity
macOS menu bar timer app swift
```

<a href="https://reposeek.ai/dashboard/playground?example=macos-menu-bar-timer">Explore in API Playground</a>

Sign in to run this request from your dashboard.

Use filters sparingly. `stars` and `forks` are hard eligibility gates, so a query with `filters.stars.min = 1000` will never return a more relevant 900-star repository.

## If results are weak

Try adding:

* framework or language: `nextjs`, `python`, `swift`, `rust`
* product category: `starter`, `template`, `sdk`, `library`, `reference app`
* deployment or license constraints: `self-hosted`, `open source`, `MIT`
* integration nouns: `stripe`, `supabase`, `oauth`, `postgres`

## Avoid

* vague queries like `best app` or `cool repo`
* implementation tasks like `write a login page`
* asking Reposeek to explain a repo's API after you have already selected it

After selecting a repo, inspect that repo's current README, docs, and source.