Amplify Next.js Starter

A modern, full-stack starter template combining the power of Next.js with AWS Amplify for building scalable web applications.

Tech Stack

• Frontend

  • Next.js 15 - React framework with App Router
  • React 19 - UI library
  • TypeScript - Type safety
  • Tailwind CSS - Utility-first CSS
  • shadcn/ui - Re-usable components

• Backend & Cloud

  • AWS Amplify - Full-stack development platform
  • AWS CDK - Infrastructure as code

• Data Management

  • TanStack Query - Data fetching and caching
  • React Hook Form - Form handling
  • Zod - Schema validation

• Development Tools

  • pnpm - Fast, disk space efficient package manager
  • ESLint - Code linting
  • Prettier - Code formatting

Getting Started

1. Prerequisites

   • Node.js 18 or later
   • pnpm package manager
   • AWS account and Amplify CLI configured

2. Installation

   # Clone the repository
   git clone https://github.com/lichtlabs/amplify-next.git
   cd amplify-next
   
   # Install dependencies
   pnpm install
   
   # Configure Amplify
   pnpm amplify:configure
   
   # Start development environment
   pnpm amplify:dev

3. Development

   # Start the Amplify sandbox environment
   pnpm amplify:dev
   
   # In a new terminal, start the development server
   pnpm dev

   Open http://localhost:3000 to view the application.

   ⚠️ Important: When you're done with development, run pnpm amplify:cleanup to destroy and clean up the sandbox resources. This helps prevent unnecessary AWS resource usage.

Available Scripts

• pnpm dev - Start development server with Turbopack
• pnpm build - Build production application
• pnpm start - Start production server
• pnpm lint - Run ESLint
• pnpm format:check - Check code formatting
• pnpm format:write - Fix code formatting
• pnpm amplify:configure - Configure Amplify profile
• pnpm amplify:dev - Start Amplify sandbox environment

Project Structure

├── amplify/          # AWS Amplify backend configuration
├── public/           # Static assets
├── src/
│   ├── app/         # Next.js App Router pages
│   ├── components/  # Reusable UI components
│   └── lib/        # Utility functions and configurations
└── package.json

Learn More

• Next.js Documentation
• AWS Amplify Documentation
• TanStack Query Documentation
• Tailwind CSS Documentation

Contributing

We welcome contributions! Please see our Contributing Guide for more details.

License

This project is licensed under the MIT License - see the LICENSE file for details.