First Run

Congratulations! 🎉

If you've completed the installation successfully, Vuesion should now be running on your local machine.

Before writing your first line of application code, take a few minutes to explore what is already included. The following tour introduces the most important parts of the project and gives you an overview of the foundation you'll be building on.

Your first tour

1. Create your account

Create your first account and complete the onboarding process.

Vuesion automatically creates your personal workspace and configures everything required to start developing immediately.


2. Explore your profile

Open your user profile and have a look at the available settings.

Try changing:

  • Your display name
  • Your profile picture
  • Your preferred language
  • Your color mode
  • Your time zone

These settings demonstrate how Vuesion handles user preferences out of the box.


3. Create another workspace

Create a second workspace and switch between both workspaces.

This gives you a first impression of one of Vuesion's core concepts: every user can belong to multiple workspaces while keeping data and permissions separated.

Don't worry if your application doesn't need workspaces. They can easily be removed if they are not part of your product.


4. Explore Storybook

Open Storybook by running npm run storybook:dev and browse through the available components.

Every component is documented, tested, and designed to work consistently across your application.

Storybook serves as the living documentation of the Vuesion Design System and is the best place to discover available UI components.


5. Explore the project

Before implementing your first feature, spend a few minutes browsing the project structure.

Pay particular attention to:

  • src/app
  • src/server
  • src/shared
  • prisma

Don't worry about understanding everything immediately. The following chapters explain the architecture and design decisions in much more detail.

What's next?

Now that you've explored the application, it's time to understand how everything fits together.

Continue with Project Structure to learn how Vuesion is organized and where new features belong.