How to replicate your project

In this tutorial, we will walk you through the process of replicating your current project within Uniscale.

If you have an existing project, you can replicate it in Uniscale by following the tutorial below and by using our Demo solution as an example of how to structure your solution, modules, pages and UX flows.

Check the "Functional Specifications: step-by-step" video for a more detailed explanation of how to write your functional specifications and follow the steps below to replicate your project.

1. Create your solution

Begin by establishing your solution in Uniscale and labeling it to align with your project.

Your solution can be inspired by the "Message Threads" layout found within our Demo solution, serving as the initial reference point when outlining your functional specifications. See it previewed below:

To get started, you must first create your solution

  • From your Uniscale dashboard, create a new product of type solution

    • or continue with the one created when you signed up in Uniscale

  • Add the required information (name, owner and optional description)

  • With the solution created, you are now ready to replicate any content you have in your other sources (could be your Google Docs, Notion pages, Confluence, etc)

Our editors support out-of-the-box copying of text styles, so you don't have to worry about losing your text structure in terms of headers and bolded text, amongst other styles.

2. Add module to the solution

Your modules will contain the main "chapters" of logic in your solution. They are sets of end-user functionality that are set and changed together.

As an inspiration, they can mirror the structure of the “Messages” module in the Demo solution, effectively categorizing similar functionalities together within its scope.

Initiate the create module flow either by slash or by clicking on the suggested help icons

Give your module a title and you are good to go.

3. Add pages to the module

Design your page to match the main structure of your project. As an inspiration, check the layout you saw in our Demo solution, called the “Timeline” page.

To add a new page, you can do so in a similar fashion to the modules, either via slash command or via inline help icons.

Initiate the create module flow either by slash or by clicking on the suggested help icons

Now you have created a page and are ready for the next step.

4. Add the functional use cases

Functional use cases are added to represent a user behavior inside your project. As such, you can identify them by assessing all the interactive elements.

An example can be found in the Timeline page in the demo, where one functional use case is Timeline view

Before adding your functional use cases, best practices are to:

A: Identify your Use Cases by determining the scenarios that need to be defined for your solution.

B: Outline each identified functional use case by :

  • expanding on the steps or actions involved

  • create mockups or prototypes to visualize user interactions

  • document specific requirements or constraints

To create a functional use case, follow the same logic as above, via the slash command or the inline helping icons

Initiate the create module flow either by slash or by clicking on the suggested help icons

Now you have created a functional use case and are ready for the next step.

5. Replicate your UX flows

Prior to adding your UX flows, best practices are to

A: Define UX Flows:

  • Map out the user experience flows within your solution.

  • Define the paths users will take to accomplish tasks.

B: Write UX Product Notes:

  • Describe design decisions, user personas, and user journey maps.

  • Provide context and rationale for UX choices.

C: Add UI Notes:

  • Specify interface elements, styling, and interactions.

  • Ensure consistency and usability across the solution.

Initiate the UX flows either by slash or by clicking on the suggested help icons

Give your UX flow a title and you are good to go.

6. Enrich with your acceptance criteria

Set your acceptance criteria based on those chosen for your project. You can find an example of such criteria in the Demo solution within a UX flow.

A: Define Criteria:

  • Clearly define acceptance criteria for each module, page, or use case.

  • Specify measurable conditions that must be met for the solution to be considered complete.

B: Ensure Alignment:

  • Align acceptance criteria with project goals and stakeholder expectations.

  • Review and iterate on criteria as needed to ensure clarity and effectiveness.

Add acceptance either by slash command or by clicking on the suggested help icons

Give your Acceptance criteria a title and you are good to go.

7: Approve your modules and solution

Repeat the above steps as much as needed to get your specification as well written as you wish.

Continuously updating the content will also add complexity to it, which we later manage with the locking cycle. Towards its end, all items should be "marked as ready".

Once everything is in place, you are now ready to create your first revision of your module.

Congratulations! 🎉 You've successfully learned how to create your solution within Uniscale and how to add modules and pages, define functional use cases, set up UX flows and UI notes, and establish acceptance criteria.

We hope this guide helps you get started with your project effectively. If you have any further questions, don't hesitate to reach out to our support team for assistance.

Happy building!

Last updated