Add READMEs and cleanup

mflix/README-JAVA-SPRING.md

@@ -21,6 +21,8 @@ This is a full-stack movie browsing application built with Java Spring Boot and
 - **MongoDB Atlas cluster or local deployment** with the `sample_mflix` dataset loaded
   - [Load sample data](https://www.mongodb.com/docs/atlas/sample-data/) 
 - **Maven** (included via Maven Wrapper)
+- **Voyage AI API key** (For MongoDB Vector Search)
+  - [Get a Voyage AI API key](https://www.voyageai.com/)
 
 ## Getting Started
 
@@ -100,11 +102,15 @@ Open your browser and navigate to:
 
 ## Features
 
-- **Browse Movies:** View a paginated list of movies from the sample_mflix dataset
-- **Search:** Full-text search using MongoDB Search
-- **Filter:** Filter movies by genre, year, rating, and more
-- **Movie Details:** View detailed information about each movie
-- **Aggregations:** Complex data aggregations and analytics
+- **Browse Movies:** View a paginated list of movies from the
+  sample_mflix dataset
+- **CRUD Operations:** Create, read, update and delete movies by using
+  the MongoDB Java driver
+- **Search:** Search movies with filters by using MongoDB Search
+- **Vector Search:** Search movie plots with similar search terms by
+  using MongoDB Vector Search
+- **Aggregations:** View data aggregations and analytics built with
+  aggregation pipelines
 
 ## Development
 
@@ -176,5 +182,5 @@ If you have problems running the sample app, please check the following:
 - [ ] Verify that you have no firewalls blocking access to the server or client ports.
 
 If you have verified the above and still have issues, please
-[open an issue](https://github.com/mongodb/docs-sample-apps/issues/new/choose)
-on the source repository `mongodb/docs-sample-apps`.
+[open an issue](https://github.com/mongodb/sample-app-java-mflix/issues/new/choose)
+on the source repository `mongodb/sample-app-java-mflix`.

mflix/README-JAVASCRIPT-EXPRESS.md

@@ -1,16 +1,198 @@
 # JavaScript Express.js MongoDB Sample MFlix Application
 
-[TODO: Add intro]
+This is a full-stack movie browsing application built with Express.js and Next.js, demonstrating MongoDB operations using the `sample_mflix` dataset. The application showcases CRUD operations, aggregations, and MongoDB Search using the native MongoDB Node.js driver.
+
+## Project Structure
 
 ```
-├── README.md
-├── client/     # Next.js frontend
-└── server/     # Express.js backend
+├── README-JAVASCRIPT-EXPRESS.md
+├── client/                 # Next.js frontend (TypeScript)
+└── server/js-express/      # Express.js backend
+    ├── src/
+    ├── package.json
+    ├── .env.example
+    └── tsconfig.json
 ```
 
+## Prerequisites
+
+- **Node.js 22** or higher
+- **MongoDB Atlas cluster or local deployment** with the `sample_mflix` dataset loaded
+  - [Load sample data](https://www.mongodb.com/docs/atlas/sample-data/) 
+- **npm** (included with Node.js)
+- **Voyage AI API key** (For MongoDB Vector Search)
+  - [Get a Voyage AI API key](https://www.voyageai.com/)
+
 ## Getting Started
 
-[TODO: Add getting started instructions explaining how to set connection string, start server, start client, etc.]
+### 1. Configure the Backend
+
+Navigate to the Express server directory:
+
+```bash
+cd server/js-express
+```
+
+Create a `.env` file from the example:
+
+```bash
+cp .env.example .env
+```
+
+Edit the `.env` file and set your MongoDB connection string:
+
+```env
+# MongoDB Configuration
+# Replace with your MongoDB Atlas connection string
+MONGODB_URI=mongodb+srv://<username>:<password>@<cluster>.mongodb.net/sample_mflix?retryWrites=true&w=majority
+
+# Server Configuration
+PORT=3001
+NODE_ENV=development
+
+# CORS Configuration (frontend URL)
+CORS_ORIGIN=http://localhost:3000
+
+# Optional: Enable MongoDB Search tests
+# Uncomment the following line to enable Search tests
+# ENABLE_SEARCH_TESTS=true
+```
+
+**Note:** Replace `<username>`, `<password>`, and `<cluster>` with your actual MongoDB Atlas credentials.
+
+### 2. Install Backend Dependencies
+
+From the `server/js-express` directory, run:
+
+```bash
+npm install
+```
+
+### 3. Start the Backend Server
+
+From the `server/js-express` directory, run:
+
+```bash
+# Development mode with hot reloading
+npm run dev
+
+# Or production mode
+npm run build
+npm start
+```
+
+The server will start on `http://localhost:3001`. You can verify it's running by visiting:
+- API root: http://localhost:3001/
+- API documentation (Swagger UI): http://localhost:3001/api-docs
+
+### 4. Configure and Start the Frontend
+
+Open a new terminal and navigate to the client directory:
+
+```bash
+cd client
+```
+
+Install dependencies:
+
+```bash
+npm install
+```
+
+Start the development server:
+
+```bash
+npm run dev
+```
+
+The Next.js application will start on `http://localhost:3000`.
+
+### 5. Access the Application
+
+Open your browser and navigate to:
+- **Frontend:** http://localhost:3000
+- **Backend API:** http://localhost:3001
+- **API Documentation:** http://localhost:3001/api-docs
+
+## Features
+
+- **Browse Movies:** View a paginated list of movies from the
+  sample_mflix dataset
+- **CRUD Operations:** Create, read, update and delete movies by using
+  the MongoDB Node.js driver
+- **Search:** Search movies with filters by using MongoDB Search
+- **Vector Search:** Search movie plots with similar search terms by
+  using MongoDB Vector Search
+- **Aggregations:** View data aggregations and analytics built with
+  aggregation pipelines
+
+## Development
+
+### Backend Development
+
+The Express.js backend uses:
+- **Express.js 5** for REST API
+- **MongoDB Node.js Driver** for database operations
+- **TypeScript** for type safety
+- **Swagger** for API documentation
+- **Jest** for testing
+
+To run tests:
+
+```bash
+cd server/js-express
+npm test
+```
+
+To run tests with coverage:
+
+```bash
+cd server/js-express
+npm run test:coverage
+```
+
+### Frontend Development
+
+The Next.js frontend uses:
+- **React 19** with TypeScript
+- **Next.js 16** with App Router
+- **Turbopack** for fast development builds
+
+#### Development Mode
+
+For active development with hot reloading and fast refresh:
+
+```bash
+cd client
+npm run dev
+```
+
+This starts the development server on `http://localhost:3000` with Turbopack for fast rebuilds.
+
+#### Production Build
+
+To create an optimized production build and run it:
+
+```bash
+cd client
+npm run build  # Creates optimized production build
+npm start      # Starts production server
+```
+
+The production build:
+- Minifies and optimizes JavaScript and CSS
+- Optimizes images and assets
+- Generates static pages where possible
+- Provides better performance for end users
+
+#### Linting
+
+To check code quality:
+
+```bash
+cd client
+npm run lint
+```
 
 ## Issues
 
@@ -22,5 +204,5 @@ If you have problems running the sample app, please check the following:
 - [ ] Verify that you have no firewalls blocking access to the server or client ports.
 
 If you have verified the above and still have issues, please
-[open an issue](https://github.com/mongodb/docs-sample-apps/issues/new/choose)
-on the source repository `mongodb/docs-sample-apps`.
+[open an issue](https://github.com/mongodb/sample-app-nodejs-mflix/issues/new/choose)
+on the source repository `mongodb/sample-app-nodejs-mflix`.

mflix/client/app/components/SearchMovieModal/SearchMovieModal.tsx

@@ -28,7 +28,7 @@ export interface SearchParams {
   cast?: string;
   limit?: number;
   skip?: number;
-  search_operator?: 'must' | 'should' | 'mustNot' | 'filter';
+  searchOperator?: 'must' | 'should' | 'mustNot' | 'filter';
   // Vector Search fields
   q?: string;
 }
@@ -42,7 +42,7 @@ interface SearchFormData {
   writers: string;
   cast: string;
   limit: string;
-  search_operator: 'must' | 'should' | 'mustNot' | 'filter';
+  searchOperator: 'must' | 'should' | 'mustNot' | 'filter';
   // Vector Search fields
   q: string;
 }
@@ -56,7 +56,7 @@ const getInitialFormData = (): SearchFormData => ({
   writers: '',
   cast: '',
   limit: '20',
-  search_operator: 'must',
+  searchOperator: 'must',
   // Vector Search fields
   q: '',
 });
@@ -115,7 +115,7 @@ export default function SearchMovieModal({
 
     if (formData.searchType === 'mongodb-search') {
       // Add MongoDB Search specific parameters
-      searchParams.search_operator = formData.search_operator;
+      searchParams.searchOperator = formData.searchOperator;
       searchParams.skip = 0; // Always start from beginning for new search
 
       if (formData.plot.trim()) {
@@ -316,13 +316,13 @@ export default function SearchMovieModal({
 
             {/* Search Operator */}
             <div className={styles.formGroup}>
-              <label htmlFor="search_operator" className={styles.label}>
+              <label htmlFor="searchOperator" className={styles.label}>
                 Search Logic
               </label>
               <select
-                id="search_operator"
-                value={formData.search_operator}
-                onChange={(e) => handleInputChange('search_operator', e.target.value)}
+                id="searchOperator"
+                value={formData.searchOperator}
+                onChange={(e) => handleInputChange('searchOperator', e.target.value)}
                 className={styles.input}
                 disabled={isLoading}
               >
@@ -333,7 +333,7 @@ export default function SearchMovieModal({
                 ))}
               </select>
               <small className={styles.searchOperatorDescription}>
-                {searchOperatorOptions.find(opt => opt.value === formData.search_operator)?.description}
+                {searchOperatorOptions.find(opt => opt.value === formData.searchOperator)?.description}
               </small>
             </div>
           </>

mflix/client/app/lib/api.ts

@@ -593,7 +593,7 @@ export async function searchMovies(searchParams: {
   cast?: string;
   limit?: number;
   skip?: number;
-  search_operator?: 'must' | 'should' | 'mustNot' | 'filter';
+  searchOperator?: 'must' | 'should' | 'mustNot' | 'filter';
 }): Promise<{ success: boolean; error?: string; movies?: Movie[]; hasNextPage?: boolean; hasPrevPage?: boolean; totalCount?: number }> {
   try {
     // Build query parameters
@@ -609,7 +609,7 @@ export async function searchMovies(searchParams: {
     if (searchParams.cast) queryParams.append('cast', searchParams.cast);
     queryParams.append('limit', limit.toString());
     queryParams.append('skip', skip.toString());
-    if (searchParams.search_operator) queryParams.append('search_operator', searchParams.search_operator);
+    if (searchParams.searchOperator) queryParams.append('searchOperator', searchParams.searchOperator);
 
     const response = await fetch(`${API_BASE_URL}/api/movies/search?${queryParams}`, {
       method: 'GET',

mflix/server/java-spring/.env.example

@@ -1,6 +1,6 @@
 # MongoDB Connection
 # Replace with your MongoDB Atlas connection string or local MongoDB URI
-MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/?retryWrites=true&w=majority
+MONGODB_URI=mongodb+srv://<username>:<password>@<cluster>.mongodb.net/sample_mflix?retryWrites=true&w=majority
 
 # Voyage AI Configuration
 # API key for Voyage AI embedding model (required for Vector Search)
@@ -15,3 +15,6 @@ PORT=3001
 # For multiple origins, separate with commas
 CORS_ORIGIN=http://localhost:3000
 
+# Optional: Enable MongoDB Search tests
+# Uncomment the following line to enable Search tests
+# ENABLE_SEARCH_TESTS=true

mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieService.java

@@ -85,7 +85,7 @@ public interface MovieService {
 
     /**
      * Finds similar movies using vector search on plot embeddings.
-     * Demonstrates MongoDB Atlas Vector Search.
+     * Demonstrates MongoDB Vector Search.
      *
      * @param movieId ID of the movie to find similar movies for
      * @param limit Maximum number of similar movies to return (default: 10, max: 50)

mflix/server/java-spring/src/main/java/com/mongodb/samplemflix/service/MovieServiceImpl.java

@@ -759,7 +759,7 @@ public List<Movie> findSimilarMovies(String movieId, Integer limit) {
                 .append("index", "plotEmbeddingIndex")
                 .append("path", "plot_embedding")
                 .append("queryVector", plotEmbedding)
-                .append("numCandidates", resultLimit * 10)
+                .append("numCandidates", resultLimit * 20) // We recommend searching 20 times higher than the limit to improve result relevance
                 .append("limit", resultLimit + 1) // +1 to exclude the source movie
         );
 
@@ -847,7 +847,7 @@ public List<VectorSearchResult> vectorSearchMovies(String query, Integer limit)
                     .append("index", "vector_index")
                     .append("path", "plot_embedding_voyage_3_large")
                     .append("queryVector", queryVector)
-                    .append("numCandidates", resultLimit * 15)  // Search more candidates for better results
+                    .append("numCandidates", resultLimit * 20)  // We recommend searching 20 times higher than the limit to improve result relevance
                     .append("limit", resultLimit)
             );