Getting Started
Welcome to Nexsas! This guide will walk you through setting up your Nexsas development environment and getting your first site running locally. Follow these step-by-step instructions to get started with customizing and developing your Nexsas project.
Prerequisites#
Before you begin, ensure your development environment meets the following requirements:
System Requirements
- Node.js version 16.14 or above (Download here)
- Operating System: Windows, macOS, or Linux
- Code Editor: VS Code, WebStorm, or your preferred editor
- Terminal/Command Line access
Installation Guide#
Step 1: Download and Extract
- Download the Nexsas package from your purchase confirmation email or from your marketplace account.
- Extract the downloaded
.zipfile to your preferred location on your local machine.
After extraction, you will see five main template folders:
-
ai-agency-tailwind. -
ai-saas-software-tailwind. -
ai-voice-generation-tailwind. -
ai-application-tailwind. -
nexsas-tailwind.
The first four folders are fully independent projects, each including:
- Dedicated inner pages
- Separate configurations
- Independent development environments
- Optimized production builds
This structure allows you to work on each template individually without affecting others.
The nexsas-tailwind folder contains all remaining templates combined together in a single project.
To improve development workflow and user experience, we began separating templates starting from Nexsas v2.2.0. The first four templates are now standalone projects.
In future versions, the templates currently grouped inside nexsas-tailwind will also be separated into individual projects — just like the four standalone templates above.
This gradual separation ensures:
- Cleaner project structure
- Better maintainability
- Improved scalability
- Easier customization
Step 2: Create Your Project Directory
-
Create a new folder for your project:
mkdir Nexsas-project cd Nexsas-project -
Copy all contents from the downloaded
developmentfolder into your project directory
Step 3: Install Dependencies
Navigate to your project directory and install the required packages:
# Navigate to your project folder
cd Nexsas-project
# Install Yarn globally (if not already installed)
npm install -g yarn
# Install project dependencies
yarn install
Alternative: If you prefer npm over Yarn, you can use
npm installinstead ofyarn install.
Step 4: Start Development Server
Launch the development server to begin working on your site:
yarn dev
Expected Output:
✓ Development server started
➜ Local: http://localhost:5173/
➜ Network: http://192.168.1.x:5173/
Your Nexsas site will be available at: http://localhost:5173/
Command Reference#
- yarn install - Installs all project dependencies
- yarn dev - Starts the development server with hot reload
- yarn build - Creates a production build of your site
- yarn preview - Previews the production build locally
- yarn format - Format your code with prettier
Verification Steps#
After completing the installation, verify everything is working correctly:
- Development Server Running: Open http://localhost:5173/ in your browser
- Hot Reload Working: Make a small change to any file and verify it updates automatically
- No Console Errors: Check browser developer tools for any error messages
Next Steps#
Now that your development environment is set up:
- Explore the Customization Guide → - Learn how to modify components, styles, and layouts
- Review the project structure - Familiarize yourself with the
src/folder organization - Start customizing - Begin modifying the template to match your requirements