🚀 novalogica | Dynamics 365 React Boilerplate

Production-ready React 19 boilerplate built with Vite for Microsoft Dynamics 365 development.
Modern, type-safe, and designed for seamless Dataverse integration.

🎯 Quick Start • 🔧 Features • 📖 Documentation

🎯 Quick Start

⚡ Create a New Project

Scaffold your production-ready app in seconds using our interactive CLI:

# Initialize a new project
npx nl-d365-boilerplate-vite@latest

🚀 Start Developing

Once created, setting up your environment is simple:

1. Enter your project:

   cd my-app-name
   npm install

2. Configure Environment:

   cp .env.example .env

   Update .env with your D365 Environment URL and Client ID.

3. Run Development Server:

   npm run dev

   Automatically handles OAuth and launches your app at http://localhost:5173.

🔧 Features

| Feature | Description | | :--- | :--- | | ⚛️ React 19 + Vite 7 | Built on the latest, fastest web standards | | 🎨 Tailwind CSS 4 | Next-gen utility-first styling with Shadcn/UI components | | 🔗 DynamicsWebApi | Type-safe Dataverse wrapper with OAuth integration | | 🛠️ TypeScript | Complete type safety for reliable code | | 🧭 Built-in Routing | Configurable page routing and navigation hooks | | 📦 Web Resource Ready | Optimized build scripts for D365 deployment |

📖 Documentation

Interactive Docs

Your new project comes with built-in interactive documentation.
Run npm start and navigate to the Documentation page for live examples.

Project Structure

src/
├── 📁 components/    # Shadcn/UI & shared components
├── 📁 config/        # App configuration & page routing
├── 📁 hooks/         # Custom hooks (e.g., useDataverse)
├── 📁 pages/         # Application views
├── 📁 providers/     # React Context providers (Theme, Auth)
└── 📁 lib/           # Utilities

🚀 Deployment

Build your application for Dynamics 365 Web Resources:

npm run build

Output:

• build/index.html → HTML Web Resource

⭐ Star on GitHub
Made with ❤️ by novalogica