Skip to content

phaylali/journey

Repository files navigation

Stone: Astro Theme (Modified by Phaylali to include an MD blogging feature)

Stone is a free and open-source Astro theme specially designed for Business, Marketing, SaaS and Startup websites.

Key Features:

  • Built with Tailwind CSS & Alpine.js
  • 5 Pages
  • 15 Sections
  • Clean & Modern Design
  • Fully Responsive
  • Dark & Light Mode
  • Fast & Performant
  • Super Lightweight
  • View Transitions (experimental)
  • Prettier Code Formatter
  • Google Fonts
  • Remix Icons
  • Free Updates
  • Supports Blogging using MD and MDX format files

Getting Started

Requirements

  • Basic knowledge of Astro, HTML and CSS.
  • Text editor (We recommend Visual Studio Code)
  • Node.js 18 or higher.

Install dependencies

Navigate to your project folder and install its dependencies:

npm install

or if you're running linux arch

npm install --ignore-scripts=false --foreground-scripts sharp

You can use Bun too but there is a problem where the above code doesn't work since Bun doesn't support Sharp yet, but it is expected to be added soon. but that problem is only with the installation , you can run this project with Bun faster than NPM.

Start

Once the installation is done, you can now run your app:

npm run dev

or even better

bun astro dev

This runs the app in development mode. Open http://localhost:3000 to view it in the browser.

Build

npm run build

or

bun astro build

This builds the app for production to the ./dist/ folder.

Project Structure

Inside the project, you'll see the following folders and files:

/
├── public/
├── src/
│   ├── components/
│   ├── content/
│   ├── layouts/
│   ├── pages/
│   └── consts.ts
├── .prettierrc
├── astro.config.mjs
├── package-lock.json
├── package.json
├── README.md
├── tailwind.config.cjs
└── tsconfig.json
  • public/* - Any static assets (images, fonts, icons, ...)
  • src/* - Project source code (components, pages, ...)
  • src/components/* - Reusable Astro components used to build pages.
  • src/layouts/* - Astro components that define the UI structure shared by one or more pages..
  • src/pages/* - Astro components used to create new pages on your site. Each page is exposed as a route based on its file name.
  • src/content/* - Blog posts made in MD, you can use MDX as well.
  • .prettierrc - Prettier configuration file.
  • astro.config.mjs - Astro configuration file.
  • package.json - File used by JavaScript package managers to manage your dependencies. It also defines the scripts that are commonly used to run Astro.
  • tailwind.config.cjs - Tailwind configuration file. The theme section is where you define your color palette and fonts.
  • tsconfig.json - TypeScript configuration file.

Deployment

Ready to build and deploy your site? Follow the official documentation.

Support

If you have any questions or suggestions do not hesitate to contact me.

License

This project is licensed under the terms of the MIT license.