Skip to main content

Getting Started

Learn how to get started with the Syngenta Warehouse Management System

Overview

The Syngenta Warehouse Management System is currently in early development. This guide will help you understand the project and get started with development.
The application is in early development with a landing page and core infrastructure in place. User-facing features are planned for future implementation.

Current Application State

The application currently includes:
1

Landing Page

The application features a landing page with “Landing Soon” message and Syngenta branding.What’s Included:
  • Syngenta logo display
  • Brand gradient styling
  • Responsive layout
  • Coming soon messaging
2

Theme System

Dark and light mode support using next-themes.Features:
  • Automatic theme switching
  • System preference detection
  • Persistent theme selection
  • Smooth transitions
3

Design System

Established Syngenta brand colors and design principles.Components:
  • Syngenta brand colors (Purple, Green, Magenta)
  • Apple-inspired design philosophy
  • Tailwind CSS v4 configuration
  • Typography system (Inter font)
4

Component Library

Initial shadcn/ui components.Available:
  • Button component with variants
  • ThemeProvider for theme management
  • cn() utility for className management

For Developers

If you’re looking to contribute to the project or set up a development environment:

Development Setup

Install dependencies and start the development server

Architecture

Understand the project structure and tech stack

Components

Learn about the component library and usage

Styling

Explore the design system and styling approach

For Product Owners

Understanding the planned features:

Features Overview

Review the planned features and roadmap

Architecture

Learn about the technical architecture

Quick Start for Development

To get started with development:
# Install dependencies
bun install

# Start development server
bun run dev

# Open http://localhost:3000
The project recommends using Bun as the package manager for optimal performance.

Development Workflow

The project follows a feature branch workflow:
  1. Create a feature branch from main
  2. Make changes incrementally
  3. Test locally with bun run dev
  4. Run type checks with bun run typecheck
  5. Format code with bun run format
  6. Push and create a pull request
  7. Vercel automatically creates preview deployment
  8. Review and merge after approval

Technology Stack

The application is built with:
  • Next.js 16.1.6 - React framework with App Router
  • React 19.2.4 - UI library
  • TypeScript 5.9.3 - Type safety
  • Tailwind CSS v4 - Styling
  • shadcn/ui - Component library
  • next-themes - Theme management
  • Bun - Package manager (recommended)

Next Steps

Getting Help

This is an early-stage project. For questions or contributions, refer to the source repository or contact the development team.

Roadmap

The project is being developed in phases:
  1. Phase 1: Core infrastructure and design system ✓
  2. Phase 2: Authentication and user management (Planned)
  3. Phase 3: Inventory management (Planned)
  4. Phase 4: Order processing (Planned)
  5. Phase 5: Reporting and analytics (Planned)

Build docs developers (and LLMs) love