Skip to main content
The AWS Certified App is a React 19 + Vite application that can be deployed in multiple ways depending on your needs. This guide covers all available deployment methods.

​
Deployment Options

Local Development

Run the app on your local machine for development or personal use

Docker Deployment

Deploy using Docker with pre-built images or custom builds

Production Deployment

Deploy to production environments with optimization and best practices

​
Quick Start

Choose the method that best fits your needs:

​
For Testing and Development

If you want to quickly test the app or contribute to development: 
npm install
npm run dev
The app will be available at http://localhost:5173

​
For Quick Deployment (Docker Hub)

The fastest way to get the app running: 
docker pull thisisrober/aws-exam-prep-app:latest
docker run -d -p 5173:5173 --name aws-exam-app thisisrober/aws-exam-prep-app:latest

​
For Production

Build an optimized production bundle: 
npm run build
npm run preview

​
System Requirements

  • Node.js: Version 18.x LTS or higher
  • npm: Version 9.x or higher (comes with Node.js)
  • Operating System: Windows 10+, macOS 10.13+, or Linux
  • Docker Engine: Version 20.10 or higher
  • Docker Compose: Version 2.0 or higher (optional)
  • Available Memory: At least 512MB RAM
  • Disk Space: Approximately 200MB for the image
Modern browsers are recommended for the best experience:
  • Chrome 90+
  • Firefox 88+
  • Safari 14+
  • Edge 90+

​
Application Architecture

The AWS Certified App is built with:
  • React 19: Modern React with latest features
  • Vite: Lightning-fast build tool and dev server
  • Tailwind CSS 4: Utility-first CSS framework
  • Lucide React: Beautiful icon library

​
Available NPM Scripts

The application includes the following npm scripts:
ScriptCommandDescription
devviteStart development server with hot reload
buildvite buildBuild optimized production bundle
previewvite previewPreview production build locally
linteslint .Run ESLint to check code quality

​
Port Configuration

By default, the application runs on port 5173. You can change this using Vite’s command-line options or environment variables.
To use a different port in development: 
npm run dev -- --port 3000
For Docker deployments, map to a different host port: 
docker run -p 8080:5173 thisisrober/aws-exam-prep-app:latest

​
Base Path Configuration

The application is configured with a base path of /projects/aws-certified-app/ in the Vite config. If you’re deploying to the root domain, you may need to modify vite.config.js.
Current configuration in vite.config.js: 
export default defineConfig({
  plugins: [react(), tailwindcss()],
  base: '/projects/aws-certified-app/',
})
For root domain deployment, change to: 
export default defineConfig({
  plugins: [react(), tailwindcss()],
  base: '/',
})

​
Next Steps

Choose your deployment method:
1

Local Development

Start with local development for testing and contributing
2

Docker Deployment

Use Docker for containerized deployments
3

Production

Follow the production guide for optimized deployments

Build docs developers (and LLMs) love

Get started for freeTalk to us