https://github.com/eoussama/no-tion
Personal Notion database helper.
https://github.com/eoussama/no-tion
notion
Last synced: 8 months ago
JSON representation
Personal Notion database helper.
- Host: GitHub
- URL: https://github.com/eoussama/no-tion
- Owner: eoussama
- License: mit
- Created: 2025-10-01T22:33:50.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-10-01T22:55:15.000Z (8 months ago)
- Last Synced: 2025-10-02T00:22:34.327Z (8 months ago)
- Topics: notion
- Language: Vue
- Homepage: https://no-tion.ouss.es
- Size: 212 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
A personal Notion account manager that provides forms to automate data insertion into Notion databases using the Notion API.
Built with Nuxt 3 with server-side API integration for secure Notion API key handling.
## Prerequisites
- Node.js `^20.19.0` or `>=22.12.0`
- pnpm (recommended) or npm
- Notion Integration Token
## Project Setup
Install dependencies:
```sh
pnpm install
```
Create a `.env` file in the root directory with your Notion API key and password:
```sh
NUXT_NOTION_API_KEY=your_notion_integration_token_here
NUXT_PASSWORD=your_secure_password_here
```
To get your Notion API key:
1. Go to [https://www.notion.so/my-integrations](https://www.notion.so/my-integrations)
2. Create a new integration
3. Copy the "Internal Integration Token"
4. Share your databases with the integration in Notion
## Development
Start the development server with hot-reload:
```sh
pnpm dev
```
The application will be available at `http://localhost:3000`
## Production Build
Type-check, compile and minify for production:
```sh
pnpm build
```
Preview the production build locally:
```sh
pnpm preview
```
Generate static site:
```sh
pnpm generate
```
## Code Quality
Lint and fix code:
```sh
pnpm lint
```
Format code:
```sh
pnpm format
```
## Architecture
- **Nuxt 3** - Full-stack Vue framework with server-side rendering
- **Server API Routes** - Notion API calls handled securely on the server
- **TypeScript** - Type-safe development
- **Notion SDK** - Official Notion JavaScript SDK
All Notion API calls are made server-side to keep your API key secure and never expose it to the client.
## Notion API Integration
This project uses the Notion API to interact with your Notion workspace. You'll need:
1. A Notion account
2. A Notion integration (API key)
3. Database IDs you want to interact with
Refer to the [Notion API documentation](https://developers.notion.com/) for setup instructions.