-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Daniel Patek
committed
Jan 10, 2025
1 parent
b36adb1
commit cb3bdb1
Showing
1 changed file
with
60 additions
and
18 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,38 +1,80 @@ | ||
# Lookout Towers | ||
|
||
This is a [Next.js](https://nextjs.org/) project bootstrapped with [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app). | ||
|
||
## Description | ||
|
||
Website of community database of **lookout towers**, observatories and other objects designed to discover beautiful views. I created this website to better connect lookout tower lovers, which of course includes me. The goal of this website is to map all lookout towers in the Czech Republic (so far), store current information about them that will be freely available to everyone, and last but not least, allow users to preserve their visits and memories. | ||
|
||
The project leverages **Next.js** for server-side rendering and static site generation, **Tailwind CSS** for styling, and follows modern **TypeScript** practices. | ||
|
||
## Features | ||
|
||
- User authentication using `next-auth v5` (found in `auth.ts`). | ||
- Modular UI components (located in `components/`). | ||
- Tailwind CSS for responsive and modern design. | ||
|
||
## Getting Started | ||
|
||
First, run the development server: | ||
Follow these steps to set up the project locally. | ||
|
||
### Prerequisites | ||
|
||
Ensure you have the following installed: | ||
|
||
- Node.js (version 22 or higher recommended) | ||
- npm or yarn | ||
|
||
### Installation | ||
|
||
1. Clone the repository: | ||
|
||
```bash | ||
git clone https://github.com/dowl-air/lookout-towers-v2.git | ||
cd lookout-towers-v2 | ||
``` | ||
|
||
2. Install dependencies: | ||
|
||
```bash | ||
npm install | ||
# or | ||
yarn install | ||
``` | ||
|
||
### Running the Development Server | ||
|
||
Start the development server: | ||
|
||
```bash | ||
npm run dev | ||
# or | ||
yarn dev | ||
# or | ||
pnpm dev | ||
``` | ||
|
||
Open [http://localhost:3000](http://localhost:3000) with your browser to see the result. | ||
|
||
You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file. | ||
|
||
[API routes](https://nextjs.org/docs/api-routes/introduction) can be accessed on [http://localhost:3000/api/hello](http://localhost:3000/api/hello). This endpoint can be edited in `pages/api/hello.ts`. | ||
|
||
The `pages/api` directory is mapped to `/api/*`. Files in this directory are treated as [API routes](https://nextjs.org/docs/api-routes/introduction) instead of React pages. | ||
|
||
This project uses [`next/font`](https://nextjs.org/docs/basic-features/font-optimization) to automatically optimize and load Inter, a custom Google Font. | ||
## Project Structure | ||
|
||
## Learn More | ||
A brief overview of the main folders and files: | ||
|
||
To learn more about Next.js, take a look at the following resources: | ||
- **`actions/`**: Contains action handlers or utilities. | ||
- **`app/`**: Main application logic, including pages and routes. | ||
- **`auth.ts`**: Authentication-related functionality. | ||
- **`components/`**: Reusable UI components. | ||
- **`public/`**: Public assets like images. | ||
- **`utils/`**: Utility functions for common tasks. | ||
- **`types/`**: TypeScript types and interfaces. | ||
|
||
- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API. | ||
- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial. | ||
## Scripts | ||
|
||
You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js/) - your feedback and contributions are welcome! | ||
Useful scripts defined in `package.json`: | ||
|
||
## Deploy on Vercel | ||
- `npm run dev`: Start the development server. | ||
- `npm run build`: Build the application for production. | ||
- `npm start`: Start the production server. | ||
- `npm run lint`: Run linter to check for code issues. | ||
|
||
The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js. | ||
## Contributors | ||
|
||
Check out our [Next.js deployment documentation](https://nextjs.org/docs/deployment) for more details. | ||
- [Daniel Patek](https://github.com/dowl-air) |