Airport Geo Search with Typesense + Next.js

This demo showcases Typesense's Geo Search features in a Next.js project.

Pre-requisistes

1. Node.js 20.x and npm
2. Typesense server. Can be hosted locally using the docker-compose.yml file in the repository, instructions in Local Setup section.
3. sqlite3

Local Setup

1. Clone the project.

2. Install dependencies at the root of the project using npm.

   npm install

3. (Optional) To run a local instance of Typesense server using the docker-compose.yml config in this repository, run the following command.

   docker compose up -d

   Note: This requires Docker to be installed on the system.

4. Copy .env.example file and create a .env file at the root of the project.

5. Set the values of required environment variables in the .env file that was created.

6. Download the airports dataset from https://ourairports.com/data/ in CSV format under dataset/source directory.
   Following CSV files are required:

   • airports.csv
   • runways.csv
   • countries.csv
   • regions.csv

7. Seed the Typesense database with the airports data by running the following command at the root of the project.

   npm run data:seed

   This command may take a while depending on the size of the data.

8. Once the Typesense database has been seeded, Next.js application can be started.

   • For production:

     npm run build
     npm start

   • For development:

     npm run dev

9. Access the application at localhost:3000.

Learn More

• Typesense - learn about Typesense.
• Next.js - learn about Next.js.

License

This project is licensed under Apache License 2.0.
The airports dataset used is by ourairports.com and relased under Public Domain.