App Miners Guide

A guide featuring insights from App Reviewers and the Blockstack PBC team

This is outdated documentation for the App Mining program. App Mining Has Been Paused. Thank you to the hundreds of you that participated and congratulations to our winners. More info & all apps →

Disclaimer: App Mining is currently being piloted by Blockstack PBC with the intent of refining it to the point it can be implemented at the protocol level on the Stacks Blockchain. The program is constantly improving thanks to feedback collected via the forum, Github, and ongoing App Mining calls with miners.


App Mining is built (and constantly refined) in a way that should help bootstrap quality applications that people want to use. As an app improves relative to others in the App Mining pool, so too should its rank and therefore the associated payout. Different independent App Reviewers focus on different aspects of what makes an app high-quality or successful, the aspect they focus on being a function of their expertise. In this guide we’ll feature advice from each of these App Reviewers so you can best understand how to score well with each, thus improving your overall score.

It's worth noting that if at any point as an App Miner, you feel compelled to do something to improve your score that you don't feel is also improving your app or helping you acquire users, it's a potential area for feedback that could improve App Mining, so please don't hesitate to use the forum or regular call to do so.

Before you begin

Zero-to-Dapp Tutorial

If you've found this guide and have not yet built an app, please start with the Zero to Dapp Tutorial. It's the easiest way for anyone to start building on Blockstack. The tutorial will not only help you start building, but will guide you through the App Mining submission process as well!

How App Mining Rankings Work

If you haven't yet, check out these two resources on how the ranking works. It's not required know how everything is calculated, but it's openly shared and calculated in the interest of transparency. This post covers the full process including a video explainer and the white paper. Recommendations from Blockstack PBC

Recommendations from Blockstack PBC

Marketing and Growth

Don’t make Marketing and Growth an afterthought. Content and social media interaction attracts new users. Apps with more users get more feedback. More feedback means better apps. Sooner than later, you’ll need to be growing your user base so don’t neglect these activities early on as they’ll support you in building and maintaining a viable project in the long-term.

How AppSumo Beat the Tech Giants


Free Ebook: The Ultimate How-to Marketing Guide


Definitive Guide to 40 Marketing Guides

All the Guides

Don’t lead with ‘decentralized’

Most people don’t care how your app works behind the scenes. The decentralized nature of Blockstack and your app is a means to an end. Focus on the value your app provides to your users instead of how it provides it. Show that your app is more secure or private, that users own their data at all times, that their data is not sold, etc. Decentralization will likely come up in describing your app, but don’t make the mistake of thinking many will jump at the app simply because it’s decentralized.

Do things that don’t scale

Get your hands dirty, do things that don’t scale. Paul Graham of Y Combinator recommends this method and it’s one that will help you find product market fit faster and more cheaply. Here are a handful of ways to find users that aren’t that scalable, but will work. Here’s another list of 17 ways to find your first 100 customers. You get the idea, there are more of these out there if you look and it’s that kind of hustle that will get your user acquisition kick-started. Beyond that, you’ll be learning along the way how to talk about your app the right way—take notes on what works so you can weave those learnings into scalable efforts down the road.

Publish content and interact

While there isn’t currently a direct measure for number of users, having real users is critical to your success. Not only do they provide the opportunity for you to build a sustainable business, they also provide feedback. Do everything you can to reach new users. In the earliest days, a mix of less scalable activities like those above and the longer-term investment in content is important. Creating content has SEO benefits (people need to find you) in addition to establishing your brand as trustworthy. Create content regularly and distribute it via social networks, groups you’re a part of, your personal network, to relevant bloggers and media, investors if you have them, your customers, and other influencers willing to listen. Start with Moz’s Beginner’s Guide to Content Marketing.

Hone your message

Chances are the first way you describe your app and its value proposition won’t be the most effective ones. Find ways to test what sticks with people and converts new users. A small spend on social or search ads will let you quickly learn what works. You should also experiment with landing pages for specific audiences. There are countless tools to make this easy, you can also pull down free templates for whatever CMS you may be working on. Check out this Beginner’s Guide to Landing Pages from Neil Patel and work on the story of your brand/app/project.

Design and Interaction

With TryMyUI officially onboard, UI is not just important, but a critical piece of the score you receive.

Get more feedback

In addition to the feedback you’ll get each month from TryMyUI, you should gather your own information too. This guide from Help Scout has some great tips for ways you can gather feedback of all kinds from customers. Real people using your app will provide you invaluable feedback.

Keep a close eye on visitor behavior

Going hand in hand with gathering feedback from users, you should find ways to ethically track website visitors so you can make strategic decisions about where they are falling off in your funnels. Analytics tools such as Fathom, Fullstory, and many more will give you insights, but be sure to take advantage of the options they provide to obfuscate personally identifiable information. Everything from the color of a button, to the image you chose, to the copy you wrote can have an effect on potential new users dropping off. An experienced designer should be able to quickly help you fix problem areas with better design and get more people all the way from your site to into your app.

Invest in graphic design work (even if lightly)

First impressions of your app (even just the logo appearing on a blog) can be the difference between someone taking your app seriously or just scrolling right past. Quality design work can be found in many places, here’s a quick list of resources you can try:

Recommendations from TryMyUI

The TryMyUI Score

TryMyUI’s panelists will score using a special survey they developed expressly for the App Mining program: the ALF Questionnaire (Adoption Likelihood Factors). Answers to this questionnaire will be used to calculate an overall score reflecting the following 4 factors:

  1. Usability: Is the app intuitive and easy to interact with? Can users perform the central functions without difficulty?
  2. Usefulness: Does the app meet a real need? Does it provide a valuable solution to a problem that users face?
  3. Credibility: Does the app inspire trust in users? Do they feel that it is safe to use? Does the information on the app feel authoritative and believable?
  4. Desirability: Do users enjoy being on the app? Does it make them want to return for future use? Are they excited about the app and what it allows them to do?

Each factor corresponds to 4 questionnaire items, for a total 16 items that comprise the ALFQ. Users mark their answers on a 5-point Likert scale, with 5 meaning “Strongly agree” and 1 meaning “Strongly disagree.” The final result is a score for each of the 4 factors, and a composite ALF score.

How to use your TryMyUI videos & data

Every month after the scores are released, you will be given access to 8 user videos from your app, with the accompanying ALF scores and written survey responses. This data will contain deep insights into the User Experience of your app – what you’re doing well, and where you can improve. All of this will be really helpful over the next few weeks as you work to improve your app design for the next month’s round of testing. Here’s our tips for diving into your TryMyUI test data:

Tip Description
Check your ALF scores first. You'll be able to see each individual tester's score. Check who had the best and worst experiences. This will be helpful to know before you start watching the videos.
Scan your written survey responses. Look for themes that appear across multiple testers' answers. Keep an eye out for any glaring issues that may have specially impacted users' experiences.
Formulate an attack plan. Now that you've reviewed the ALF scores and written responses, start watching your videos. You already have an idea of the kinds of issues you'll find, and which users experienced those issues, so start there. This will allow you to quickly identify your main areas for improvement, and to understand why users are having trouble in those spots.
Take notes. As you watch your videos, take notes on what you see. Users will give verbal feedback as they go, explaining their thoughts, reactions, and impressions of your app. Look in particular for gaps between what they expected and the actual experience your app delivered.
Read between the lines. Observe what users do as well as what they say. The verbal feedback is important, but sometimes users won't comment on every issue, or even realize that something has gone wrong! Pay close attention to behaviors that are different from what you anticipated, or things that are hindering users' progress towards your desired outcomes.
Interpret your findings. Figure out what users' feedback means for your roadmap by identifying the problem at the root of their complaints. For example, a user might wish for a video tutorial, but that doesn't necessarily mean you should add a video tutorial. Instead, think about what's missing from the information you currently provide that caused the user to feel so disoriented.
Look for positives too! Your TryMyUI data won't just show you where things aren't working smoothly, it will also show you what you're doing right. It's important to take note of these insights, so you can emphasize those elements and avoid eliminating features that people like.

UI/UX Recommendations

Here are some quick tips from the TryMyUI team on improving your app’s design and providing better experiences for your users:

  • First impressions matter! Clearly communicate your main value proposition up front. If visitors don’t understand what you can do for them, they won’t even bother moving on to the next step.

  • Pretty isn’t everything, but a visually attractive design increases your credibility and makes users feel more comfortable using your app. A good-looking homepage will start you off on the right foot with users.

  • Show, don’t tell. People never read as much as you think. Wherever possible, try to explain your app’s benefits and functionalities with a combination of text, illustration, and interaction.

  • Define user personas and stories, and design your app based on these. If you can step into the shoes of your users, you’ll be better able to create something they’ll want to use.

  • Simplify. Trim the fat in your designs. Simple is better – focus on the main actions, and minimize distractions.

Analyzing and improving your UX

Understanding first impressions on your site

Read More

5 psychology principles for better UX design

Read More

Smashing Magazine

A Comprehensive Guide To Mobile App Design

See the Guide

Recommendations from Awario

Generally speaking, Awario is an App Reviewer that ranks apps based on awareness. The underlying goal of App Mining is to accelerate growth of the decentralized app ecosystem, a key part of which is attracting users. Attracting users depends on creating marketplace awareness of an app through effective marketing.

Awario assesses the reach of your marketing efforts and looks at your monthly marketing activity to determine how your overall awareness ranks relative to other apps in the program. Each month, Awario also provides you with valuable data the informs you about your apps online mention, influencer, and online sentiment. This is the data behind your rank. You can use this data to further enhance your marketing efforts and increase your app’s score.

Note: Awareness level is only one part of your score. To read more about the components of a score, see this How apps are reviewed and scored here. Also, watch the changelog and attend App Mining meetings to stay aware of scoring changes for Awario or other App Reviewers.

Anatomy of Awario’s awareness level

Awario uses mentions and reach to determine your apps awareness level.

mentions A public instance of your App’s name being found online (social networks, media, blogs, websites, etc.). Each mention must use the exact app name, no typos or misspellings. Images do not count as mentions.
reach An estimation of how many people are involved in and exposed to the conversation around your app.

For each of the mentions found, Awario assigns a reach number. A more popular blog will have higher reach number than a less popular one. Awario scans the web for Mentions of your app across 3 main areas:

social Facebook, Twitter, Instagram, Reddit, and YouTube. For Instagram and YouTube, use the caption area to mention your app name. For Instagram, your account needs to be set to Business.
news/blog The Wall Street Journal, Wired, The Verge, etc. as well as smaller blogs that have a history of reporting news or media style content. What constitutes a News/Blog mention is determined by Awario’s algorithms.
web Mentions on a website not considered a News or Blog site. These mentions are not factored into your App Mining rank

Finally, you should understand that your awareness rank drives your growth score. To receive a Growth score, your app must achieve reach rank of at least 1,000 in the month. Scores are run on GMT, not your own local timezone. Therefore any mention needs to occur within the past calendar month according to GMT.

Tips for maximizing your Awario score

Get at least one public post on each social network mentioning your App’s name. This is a simple as an update on Facebook, a Tweet, a Reddit post, etc.

Mentions must:

  • Use the exact app name in the body of the text or update. Misspellings or typos or if the mention appears in a sidebar such as related articles are not recorded in your rank.
  • images that contain your app name only count when the app name also appears in a images alt caption, for example: <img src="myappgif.gif" alt="APP NAME">
  • Posts must be publicly viewable.
  • You can have friends, your personal accounts, or other brands mention you on social networks (this is actually ideal for your app in the long-term), it’s not restricted to what you post as the app brand itself.
  • For Instagram and YouTube, use the caption area to mention your app name.
  • For Instagram, your account needs to be set to Business.

Get placements in News/Blog sites:

  • Reach out to the writers for sites like TechCrunch, The Verge, WSJ, and so forth (tips for locating the writers). Pitch them on why they should cover what you’re building. With these folks, the broader implications of privacy and security tend to go farther than specifics about your app. Human interest is another good angle, i.e. talk about who your app serves and why it’s important users have it.
  • Make yourself and your team available for interviews.
  • Work with a PR firm.
  • Hire a freelance writer to help tell your story (or a PR freelancer), these people can help pull out what the media will care most about and get something placed.
  • Jump on existing news and join the conversation (newsjacking).
  • Focus on the WHY and the WHO, when it comes to all your marketing efforts, not the HOW. What is the value your app provides?

Be steady with your efforts. Just like in the real-world, marketing is a constant and long-term investment. If you drop off for a month or two, that will reverberate negatively in your real-world awareness and in your score. Some further reading on earning press:

Recap of important guidelines

  • Each mention must use the exact app name, no typos or misspellings.
  • Images do not count as mentions unless the app name also appears in a text caption.
  • To receive a Growth score, you need to hit a reach rank of at least 1,000 in the month.
  • For Instagram, your account needs to be set to Business.
  • Mentions in websites other than blog or news, are not counted.

Thank you!

We hope you enjoyed this guide and are enjoying your App Mining experience. Please contact at any time with suggestions or questions.