I wanted to learn NextJS for a few months. Now the time have come and I created a server for displaying markdown blog posts. So this is my first project using NextJS.

When noticing the new appwrite hackathon, I decided to add a feature to store your markdown post files in a appwrite database.

If you are planning to add posts via the Appwrite Database capability, you need to have a Appwrite instance running on your local machine or on a server.

Files should be stored in a bucket in the storage and their ids must match the file name in order to be found!

1. configuration.json in config
   • Example AppwriteDB

    "appwriteDatabase": {
        "url": {
            "host": "localhost",
            "port": 3000
        },
        "projectId": "YOUR_PROJECT_ID",
        "postBucketId": "YOUR_POST_BUCKET_ID",
        "apiKey": "YOUR_API_KEY"
    }

2. Environment variables .env or Docker -e
   • Example AppwriteDB

ENV_APPWRITEDATABASE_URL_HOST=localhost
ENV_APPWRITEDATABASE_URL_PORT=3000
ENV_APPWRITEDATABASE_PROJECTID=YOUR_PROJECT_ID
ENV_APPWRITEDATABASE_POSTBUCKETID=YOUR_POST_BUCKET_ID
ENV_APPWRITEDATABASE_APIKEY=YOUR_API_KEY

All Configuration keys:

When changing the configuration, you need to restart the server.

• Volumes:
  • config: for accessing the configuration file
  • posts: when wanting to add posts via file explorer
  • public/images: when wanting to add images
• Ports:
  • 3000: for displaying NextJS frontend

1. docker pull ghcr.io/tim0-12432/markdown-blog:latest
2. docker run --name markdown-blog -d -p 8082:3000 -v markdown-blog_config:/config -v markdown-blog_posts:/posts -v markdown-blog_images:/public/images -e <ENVIRONMENT_VARIABLES> ghcr.io/tim0-12432/markdown-blog:latest

1. Clone the repository
2. Install the dependencies via npm install
3. Build the application via npm run build
4. Run the server via npm run start

graph TD
    A[(Appwrite DB)] --> N[NextJS Server]
    P[(Posts Directory)] --> N
    N --> F[NextJS Frontend]

device	light	dark
desktop
mobile

All colors are configurable!

mobile	desktop

MIT