🚀 Astro Appwrite Starter Kit

Accelerate Your Web Development Journey

Welcome to Your Next Web Project

A minimal template for Astro projects with Appwrite integration, designed to accelerate modern web application development.

📋 Prerequisites

Before getting started, ensure you have installed:

🟢 Node.js Version 22 or higher

🔴 Appwrite Version 2 or higher

🖥️ Appwrite CLI Installation Guide (recommended)

💻 VSCode (recommended)

🛠️ Technologies and Dependencies

Frontend

Astro

Modern web framework

TypeScript

Static typing

WebCoreUI

Component library

Sass

CSS preprocessor

🚀 Getting Started

git clone https://github.com/emanuelsaramago/astro-appwrite-starter.git
cd astro-appwrite-starter

```
npm install
```
1. Copy .env.example to .env
2. Create a new project in your Appwrite instance, then:
  - Set up a database, collection, and user
  - Generate an API key
3. Fill the .env file with the required values

# Initialize project
appwrite init project

# Generate TypeScript types
appwrite types src/types

🖥️ Development

Start Development Server

In VSCode:

Go to Debugger Mode
Select "Development server"
Click "Start Debugging" button or press F5
Open in browser: http://localhost:1234

🧩 UI Components

UI component documentation: WebCoreUI Docs

📂 Folder Structure

src/
├── components/   # Reusable UI components
├── layouts/      # Layout templates
├── pages/        # Pages and API routes
├── styles/       # Global styles
├── utils/        # Utility functions
└── lib/          # Appwrite client and services

🤝 Contributing

Feel free to open issues or send pull requests. All contributions are welcome!

📄 License

This project is under the MIT License. See the LICENCE.md file for more details.

Ready to Build Something Amazing?

This starter kit provides a solid foundation for your web projects. Whether you're building a personal blog, a complex web application, or exploring modern web technologies, you're in the right place.