add readme
This commit is contained in:
parent
83337e0574
commit
96761cb911
1 changed files with 60 additions and 0 deletions
60
README.md
Normal file
60
README.md
Normal file
|
|
@ -0,0 +1,60 @@
|
||||||
|
# kuwot-api-js
|
||||||
|
|
||||||
|
A Node.js REST API built with TypeScript and Express.
|
||||||
|
|
||||||
|
## Getting Started
|
||||||
|
|
||||||
|
### Prerequisites
|
||||||
|
- Node.js >= 18
|
||||||
|
- npm
|
||||||
|
|
||||||
|
### Installation
|
||||||
|
```sh
|
||||||
|
npm install
|
||||||
|
```
|
||||||
|
|
||||||
|
### Configuration
|
||||||
|
1. Copy `.env.example` to `.env` and fill in your secrets:
|
||||||
|
```sh
|
||||||
|
cp .env.example .env
|
||||||
|
```
|
||||||
|
2. Set your Unsplash access key and other variables in `.env`.
|
||||||
|
|
||||||
|
### Running the Server
|
||||||
|
```sh
|
||||||
|
npm start
|
||||||
|
```
|
||||||
|
|
||||||
|
### Formatting Code
|
||||||
|
```sh
|
||||||
|
npm run format
|
||||||
|
```
|
||||||
|
|
||||||
|
### Recommended VS Code Extensions
|
||||||
|
- ESLint
|
||||||
|
- Prettier
|
||||||
|
|
||||||
|
## Project Structure
|
||||||
|
```
|
||||||
|
kuwot-api-js/
|
||||||
|
├── src/
|
||||||
|
│ ├── index.ts # Entry point
|
||||||
|
│ ├── routes.ts # API routes
|
||||||
|
│ ├── types.d.ts # Type definitions
|
||||||
|
│ └── data/
|
||||||
|
│ ├── db.ts # Database logic
|
||||||
|
│ └── unsplash.ts # Unsplash API integration
|
||||||
|
├── .env.example # Example environment variables
|
||||||
|
├── .gitignore # Git ignore rules
|
||||||
|
├── package.json # Project metadata and scripts
|
||||||
|
├── tsconfig.json # TypeScript configuration
|
||||||
|
└── .vscode/
|
||||||
|
├── launch.json # Debug configuration
|
||||||
|
└── extensions.json # Recommended extensions
|
||||||
|
```
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
|
||||||
|
|
||||||
|
## License
|
||||||
|
ISC
|
||||||
Loading…
Add table
Add a link
Reference in a new issue