Installation

Prerequisites

Before you begin, make sure you have the following installed:

• Node.js 18.0 or higher
• npm 8.0 or higher (or yarn/pnpm)
• Git (for cloning the repository)

Step 1: Download from GitHub

Download the latest version of NeoSaaS from the official GitHub repository at https://github.com/neosaastech/neosaas

git clone https://github.com/neosaastech/neosaas.git

cd neosaas

Step 2: Install Node Dependencies

Install all required Node.js packages using npm:

npm install

This will install Next.js 16, Tailwind CSS, Drizzle ORM, and all other dependencies defined in package.json.

Step 3: Configure Environment Variables

Create a .env file in the root of your project. You can copy the example file:

cp .env.example .env

Configurez vos variables d'environnement, notamment la DATABASE_URL (depuis Neon, Scaleway ou PostgreSQL local) :

DATABASE_URL="postgresql://username:password@localhost:5432/neosaas"

Step 4: Déployez votre application

Une fois vos variables d'environnement configurées, déployez simplement votre application. Le système s'occupe de tout :

• Installation automatique de la base de données
• Création des tables et schémas nécessaires
• Configuration de l'environnement de production

Le site sera accessible dès que le déploiement sera terminé. Aucune commande de migration manuelle n'est requise !

Step 5: Créez votre premier utilisateur administrateur

Lors de votre première connexion, utilisez les identifiants par défaut :

Step 6: Accédez au Dashboard

Une fois connecté avec vos identifiants administrateur, vous pouvez accéder au dashboard pour développer et gérer les services de votre projet :

• Gestion des utilisateurs et des rôles
• Configuration des services et intégrations
• Tableau de bord analytique
• Gestion du contenu et des produits
• Configuration des paiements et abonnements

Le dashboard est votre interface centrale pour développer et gérer tous les aspects de votre application SaaS.

Step 7: Développement local (optionnel)

Pour le développement en local, démarrez le serveur de développement Next.js :

npm run dev

Votre application sera disponible à l'adresse http://localhost:3000

Accédez au dashboard administrateur à http://localhost:3000/dashboard