Initial commit

README.md

@@ -0,0 +1,42 @@
+# AdAstra_App
+
+## Libraries and Frameworks
+
+| Name                                          |                                    |
+| --------------------------------------------- | ---------------------------------- |
+| [TypeScript](https://www.typescriptlang.org/) | v5.5.x                             |
+| [Next.js](https://nextjs.org/)                | v15.x                              |
+| [React](https://react.dev/)                   | v18.x                              |
+| [Conform](https://conform.guide/)             | form validation library            |
+| [Zod](https://zod.dev/)                       | schema validation library          |
+| [unified](https://unifiedjs.com/)             | markdown to html converter         |
+| [OpenAPI TypeScript](https://openapi-ts.dev/) | type generator from OpenAPI schema |
+
+## Getting Started
+
+```bash
+# copy env
+cp .env.example .env.local
+
+# set API_BASE_URL variable in .env.local to your backend api endpoint
+
+# run app
+npm run dev
+```
+
+## Directory structure
+
+```plaintext
+.
+├── api/                  # api schema
+├── public/               # static assets
+└── src/
+    ├── app/              # web routes
+    ├── config/           # global configuration and constants
+    ├── generated/        # automatically generated codes
+    ├── modules/
+    │   ├── common/       # common (feature-independent) components
+    │   └── features/     # feature-specific components
+    ├── styles/           # global style sheets
+    └── utils/            # utilities
+```