Installation Guide
Welcome to the Vuexy installation guide! ๐ Leveraging Create Next App, we've streamlined the setup to kickstart your project automatically and efficiently.
๐ Getting Startedโ
Before you begin, ensure Node.js is installed along with one of the following package managers: pnpm, yarn, or npm.
Package Manager: pnpm
is our preferred choice for its speed and efficiency.
Node Version: Stick to the LTS version recommended on the official Node.js site. Our template is optimized for this version to avoid compatibility issues.
Hidden Files: Ensure files starting with a dot (.eslintrc, .env.example, etc.) are visible and copied correctly. This is crucial for a successful setup, as missing hidden files can occur if they're not enabled on your system.
Project Setup:โ
-
Download the Vuexy zip and place it in your chosen directory before unzipping. This step prevents the loss of hidden files during transfer.
-
Inside, you'll find
typescript-version
andjavascript-version
folders, each withfull-version
&starter-kit
. Select the one that suits your project needs and open it in your code editor.
Environment Variables Configuration:โ
-
Rename
.env.example
to.env
. -
Populate the
.env
file with your specific values. -
In the
full-version
, generate a secureNEXTAUTH_SECRET
as suggested here. -
For Google authentication in the
full-version
, includeGOOGLE_CLIENT_ID
andGOOGLE_CLIENT_SECRET
in the.env
file.
Dependency Installationโ
Run the install command using your chosen package manager from the options below:
- pnpm (Highly Recommended)
- yarn
- npm
pnpm install
yarn install
npm install
Launch Projectโ
Initiate your project with the start command tailored for your package manager:
- pnpm (Highly Recommended)
- yarn
- npm
pnpm dev
yarn dev
npm run dev
๐ Success! Once the command runs successfully, your console will show the project is active. Visit http://localhost:3000
to view your work in action.
Your network URL might differ from examples shown; this is normal and depends on your specific network setup.
Change the port by adding --port <port-number>
or -p <port-number>
to your launch command. Update the .env
file's URL to reflect the new port, e.g., pnpm dev --port 3001
changes the URL to http://localhost:3001
.
Begin your Vuexy adventure with joy and efficiency! ๐