api.dileepa.dev

This is the API for Dileepa's personal website (dileepa.dev), built with NestJS. It provides various endpoints to access information about Dileepa and other related data.

Table of Contents

• api.dileepa.dev
  • Table of Contents
  • Tools and Technologies
  • Installation
  • Running the App
    • Development
    • Production
  • API Documentation
  • Testing
  • Versioning
  • Contributing
  • Issues
  • Security
  • License
  • API Endpoints
  • Deployment on Azure
  • Contact

Tools and Technologies

• Framework: NestJS
• Language: TypeScript
• Runtime: Node.js
• Package Manager: npm
• Linting: ESLint
• Formatting: Prettier
• Version Control: Git
• Database: MongoDB (using Mongoose)
• Deployment: Azure App Service
• Image Hosting: Azure Blob Storage
• Documentation: Swagger (using Swagger UI)

Installation

1. Clone the repository:

   git clone https://github.com/dileepadev/api.dileepa.dev.git
   cd api.dileepa.dev

2. Install dependencies:

   npm install

3. Copy the example environment file and update it with your configuration:

   cp .env.example .env
   # Then edit .env as needed

Running the App

Development

To run the application in development mode with file watching:

npm run start:dev

The application will be available at http://localhost:3000 (or the configured port in .env).

Production

To build and run the application in production mode:

npm run build
npm run start:prod

API Documentation

Swagger UI is available at /api once the app is running. (e.g., http://localhost:3000/api)

Testing

To run tests:

npm run test

Versioning

This project follows a versioning pattern similar to Semantic Versioning (SemVer) for managing releases. For detailed versioning information, see the VERSIONING.md file.

Contributing

Contributions are welcome! Please read the following before contributing:

• CONTRIBUTING.md
• CODE_OF_CONDUCT.md
• BRANCH_NAMING_GUIDELINES.md
• COMMIT_MESSAGE_GUIDELINES.md
• PULL_REQUEST_GUIDELINES.md

Issues

For any issues or feature requests, please use the issue templates provided in the repository. You can also check the CHANGELOG.md for updates and changes.

Security

If you discover any security vulnerabilities, please report them as described in SECURITY.md.

License

This project is licensed under the terms of the LICENSE file.

API Endpoints

Endpoint	Description
/about	Provides general profile information about me.
/experiences	Returns a list of my professional work experiences.
/educations	Displays my academic background, including degrees.
/events	Lists upcoming and past events, talks, or appearances.
/videos	Links to video content such as talks or tutorials.
/blogs	Returns metadata or summaries of blog posts.
/communities	Tech communities I've volunteered with.
/tools	Lists the tools, frameworks, and technologies I use.

Deployment on Azure

This project is designed for deployment on Azure App Service and uses Azure Blob Storage for image hosting. For deployment instructions, see the official Azure documentation.

Contact

For any inquiries or feedback, please reach out to me via email or through my website.